| 構文 | DATE(expression)
|
| 出力 | 日付 |
| 定義 | 指定された数値、文字列、または日付の <expression> に対して、日付を返します。 |
| 例 | DATE([Employee Start Date]) DATE("September 22, 2018") DATE("9/22/2018")DATE(#2018-09-22 14:52#) |
| 注 |
|
| 構文 | DATEADD(date_part, interval, date)
|
| 出力 | 日付 |
| 定義 | 指定された <date> の指定された <date_part> に、<interval> で指定された数値を追加した日付を返します。例えば、開始日に 3 か月を足したり、12 日間を足したりするなどです。 |
| 例 |
すべての締め切り日を 1 週間延長する DATEADD('week', 1, [due date])
2021 年 2 月 20 日の 280 日後 DATEADD('day', 280, #2/20/21#) = #November 27, 2021#
|
| 注 | ISO 8601 の日付をサポートしています。 |
| 構文 | DATEDIFF(date_part, date1, date2, [start_of_week])
|
| 出力 | 整数 |
| 定義 | <date_part> の単位で表された、<date1> と <date2> の差異を返します。例えば、バンドに入った日と抜けた日を引き算して、その人がバンドにいた期間を確認します。 |
| 例 |
1986 年 3 月 25 日と 2021 年 2 月 20 日の間の日数 DATEDIFF('day', #3/25/1986#, #2/20/2021#) = 12,751
その人がバンドに参加していた月数 DATEDIFF('month', [date joined band], [date left band])
|
| 注 | ISO 8601 の日付をサポートしています。 |
| 構文 | DATENAME(date_part, date, [start_of_week])
|
| 出力 | 文字列 |
| 定義 | <date> の <date_part> を文字列として返します。 |
| 例 | DATENAME('year', #3/25/1986#) = "1986"DATENAME('month', #1986-03-25#) = "March"
|
| 注 |
ISO 8601 の日付をサポートしています。 よく似た計算に DATEPART があります。これは、指定された日付部分の値を、連続した整数として返します。 計算結果の属性 (ディメンションかメジャーか、連続か不連続か) と日付の書式を変更すると、 逆関数 DATEPARSE は、文字列値を受け取り、日付として書式設定します。 |
| 構文 | DATEPARSE(date_format, date_string)
|
| 出力 | 日付 |
| 定義 | <date_format> 引数は <date_string> フィールドがどのように配置されているかを示します。文字列フィールドはさまざまな順序で配置することができるため、<date_format> は正確に一致する必要があります。完全な説明と書式設定の詳細については、「フィールドを日付フィールドに変換する」を参照してください。 |
| 例 | DATEPARSE('yyyy-MM-dd', "1986-03-25") = #March 25, 1986#
|
| 注 |
|
| データベースの制限 |
|
| 構文 | DATEPART(date_part, date, [start_of_week])
|
| 出力 | 整数 |
| 定義 | <date> の <date_part> を整数として返します。 |
| 例 | DATEPART('year', #1986-03-25#) = 1986DATEPART('month', #1986-03-25#) = 3
|
| 注 |
ISO 8601 の日付をサポートしています。 よく似た計算に 逆関数 |
| 構文 | DATETRUNC(date_part, date, [start_of_week])
|
| 出力 | 日付 |
| 定義 | <date_part> で指定された精度で <date> を切り捨てます。この関数は新しい日付を返します。たとえば、月の中旬にある日付を月レベルで丸めた場合、この関数はその月の第 1 日を返します。 |
| 例 | DATETRUNC('day', #9/22/2018#) = #9/22/2018#DATETRUNC('iso-week', #9/22/2018#) = #9/17/2018#
(2018/9/22 を含む週の月曜日) DATETRUNC(quarter, #9/22/2018#) = #7/1/2018# (2018/9/22 を含む四半期の最初の日) 注: 週と ISO 週では、 |
| 注 |
ISO 8601 の日付をサポートしています。
例えば、 |
| 構文 | DAY(date)
|
| 出力 | 整数 |
| 定義 | 指定された <date> の日の部分を整数として返します。 |
| 例 | Day(#September 22, 2018#) = 22 |
| 注 | WEEK、MONTH、QUARTER、YEAR、および ISO の相当するものも参照してください。 |
| 構文 | ISDATE(string)
|
| 出力 | ブール値 |
| 定義 | 指定された <string> が有効な日付の場合、true を返します。 |
| 例 | ISDATE(09/22/2018) = true ISDATE(22SEP18) = false |
| 注 | 必須の引数は文字列でなければなりません。ISDATE は、日付データ型のフィールドには使用できません。計算によりエラーが返されます。 |
| 構文 | ISOQUARTER(date)
|
| 出力 | 整数 |
| 定義 | 指定された <date> の ISO8601 週ベースの四半期の部分を整数として返します。 |
| 例 | ISOQUARTER(#1986-03-25#) = 1 |
| 注 | ISOWEEK、ISOWEEKDAY、ISOYEAR、および非 ISO の相当するものも参照してください。 |
| 構文 | ISOWEEK(date)
|
| 出力 | 整数 |
| 定義 | 指定された <date> の ISO8601 週ベースの週を整数で返します。 |
| 例 | ISOWEEK(#1986-03-25#) = 13 |
| 注 | ISOWEEKDAY、ISOQUARTER、ISOYEAR、および非 ISO の相当するものも参照してください。 |
| 構文 | ISOWEEKDAY(date)
|
| 出力 | 整数 |
| 定義 | 指定された <date> の ISO8601 週ベースの曜日を整数で返します。 |
| 例 | ISOWEEKDAY(#1986-03-25#) = 2 |
| 注 | ISOWEEK、ISOQUARTER、ISOYEAR、および非 ISO の相当するものも参照してください。 |
| 構文 | ISOYEAR(date)
|
| 出力 | 整数 |
| 定義 | 指定された <date> の ISO8601 週ベースの年を整数で返します。 |
| 例 | ISOYEAR(#1986-03-25#) = 1,986 |
| 注 | ISOWEEK、ISOWEEKDAY、ISOQUARTER、および非 ISO の相当するものも参照してください。 |
| 構文 | MAKEDATE(year, month, day)
|
| 出力 | 日付 |
| 定義 | 指定された <year>、<month>、<day> から構成される日付値を返します。 |
| 例 | MAKEDATE(1986,3,25) = #1986-03-25# |
| 注 |
注: 値を誤って入力した場合、4 月 31 日は存在しないというエラーが返されるのではなく、 Tableau のデータ抽出で利用できます。他のデータ ソースで利用可能か確認します。
|
| 構文 | MAKEDATETIME(date, time)
|
| 出力 | 日時 |
| 定義 | <date> と <time> を組み合わせた日付時刻を返します。日付は、日付、日付時刻、または文字列の種類になることがあります。時刻は日付時刻である必要があります。 |
| 例 | MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM# |
| 注 |
この関数は、MySQL 互換の接続 (Tableau では MySQL および Amazon Aurora) でのみ使用できます。
|
| 構文 | MAKETIME(hour, minute, second)
|
| 出力 | 日時 |
| 定義 | 指定された <hour>、<minute>、<second> から構成される日付値を返します。 |
| 例 | MAKETIME(14, 52, 40) = #1/1/1899 14:52:40# |
| 注 |
Tableau は時刻のデータ型をサポートしておらず、日付時刻のみをサポートしているため、出力は日付時刻になります。フィールドの日付部分は 1899 年 1 月 1 日になります。 MYSQL 互換の接続でのみ使用できる |
| 構文 | MAX(expression) または MAX(expr1, expr2) |
| 出力 | 引数と同じデータ型、または引数の一部が Null の場合 NULL。 |
| 定義 |
2 つの引数の最大値を返します (2 つの引数は同じ型でなければなりません)。
|
| 例 | MAX(4,7) = 7 |
| 注 |
文字列の場合
データベースのデータ ソースでは、 日付の場合 日付の場合、 集計として
比較として
|
| 構文 | MIN(expression) または MIN(expr1, expr2) |
| 出力 | 引数と同じデータ型、または引数の一部が Null の場合 NULL 。 |
| 定義 |
2 つの引数の最小値を返します (2 つの引数は同じ型でなければなりません)。
|
| 例 | MIN(4,7) = 4 |
| 注 |
文字列の場合
データベースのデータ ソースでは、 日付の場合 日付の場合、 集計として
比較として
|
| 構文 | MONTH(date)
|
| 出力 | 整数 |
| 定義 | 指定された <date> の月を整数で返します。 |
| 例 | MONTH(#1986-03-25#) = 3 |
| 注 | DAY、WEEK、QUARTER、YEAR、および ISO の相当するものも参照してください。 |
| 構文 | NOW()
|
| 出力 | 日時 |
| 定義 | 現在のローカル システムの日付と時刻を返します。 |
| 例 | NOW() = 1986-03-25 1:08:21 PM |
| 注 |
日付時刻でなく日付を返す同様の計算である データ ソースがライブ接続の場合、システムの日付と時刻は別のタイムゾーンになる可能性があります。これに対処する方法の詳細については、「ナレッジベース」を参照してください。 |
| 構文 | QUARTER(date)
|
| 出力 | 整数 |
| 定義 | 指定された <date> の四半期を整数で返します。 |
| 例 | QUARTER(#1986-03-25#) = 1 |
| 注 | DAY、WEEK、MONTH、YEAR、および ISO の相当するものも参照してください。 |
| 構文 | TODAY()
|
| 出力 | 日付 |
| 定義 | 現在のローカル システムの日付を返します。 |
| 例 | TODAY() = 1986-03-25 |
| 注 |
日付ではなく日付時刻を返す同様の計算である NOW も参照してください。 データ ソースがライブ接続の場合、システムの日付は別のタイムゾーンになる可能性があります。これに対処する方法の詳細については、「ナレッジベース」を参照してください。 |
| 構文 | WEEK(date)
|
| 出力 | 整数 |
| 定義 | 指定された <date> の週を整数で返します。 |
| 例 | WEEK(#1986-03-25#) = 13 |
| 注 | DAY、MONTH、QUARTER、YEAR、および ISO の相当するものも参照してください。 |
| 構文 | YEAR(date)
|
| 出力 | 整数 |
| 定義 | 指定された <date> の年を整数で返します。 |
| 例 | YEAR(#1986-03-25#) = 1,986 |
| 注 | DAY、WEEK、MONTH、QUARTER、および ISO の相当するものも参照してください。 |
| 形式 | データ型 | 値 |
| 'March 25, 1986' | 文字列 | 'March 25, 1986' |
| #1986/03/25# | 日付 | #1986/03/25# |
| #1986/03/25# | 浮動小数 | 0.00006042 |
| #1986/03/25# | 整数 | 1,958 |
| March 25, 1986 | - | 無効 |