日付関数

説明

指定された日付と指定した interval の数を、指定されたその日付の date_part に追加して返します。

ISO 8601 の日付をサポートしています。

例:

DATEADD('month', 3, #2004-04-15#) = 2004-07-15 12:00:00 AM

この式は日付 #2004-04-15# に 3 か月を追加します。

date_part の単位で表された、date1 と date2 の差異を返します。

週の始まりと見なす曜日を指定する start_of_week パラメーターはオプションです。考えられる値は「monday」、「tuesday」などです。省略される場合、週の始まりはデータ ソースによって決定されます。詳細については、データ ソースの日付のプロパティを参照してください。

ISO 8601 の日付をサポートしています。

例:

DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'monday')= 1
DATEDIFF('week', #2013-09-22#, #2013-09-24#, 'sunday')= 0

start_of_week が 'monday' の場合、9 月 22 日 (日曜日) と 9 月 24 日 (火曜日) は別の週になるため、最初の式は 1 を返します。start_of_week が 'sunday' の場合、9 月 22 日 (日曜日) と 9 月 24 日 (火曜日) は同じ週になるため、2 番目の式は 2 を返します。

date の date_part を文字列として返します。週の始まりと見なす曜日を指定する start_of_week パラメーターはオプションです。考えられる値は「monday」、「tuesday」などです。start_of_week が省略されると、週の始まりはデータ ソースによって決定されます。詳細については、データ ソースの日付のプロパティを参照してください。

ISO 8601 の日付をサポートしています。

例:

DATENAME('year', #2004-04-15#) = "2004"
DATENAME('month', #2004-04-15#) = "April"

日付として [date_string] を返します。date_format 引数は [文字列] フィールドがどのように配置されているかを示します。文字列フィールドはさまざまな順序で配置することができるため、date_format は正確に一致する必要があります。詳細については、「フィールドを日付フィールドに変換する」を参照してください。

例:

DATEPARSE('yyyy-MM-dd', #2004-04-15#) = "April 4, 2004"

注:この関数を使用できるコネクタは、非レガシーの Excel およびテキスト ファイル接続、Amazon EMR の Hadoop Hive、Cloudera Hadoop、Google スプレッドシート、Hortonworks Hadoop Hive、MapR Hadoop Hive、MySQL、Oracle、PostgreSQL、および Tableau 抽出です。書式設定によってはすべての接続で使用できない場合があります。

注: DATEPARSE は Hive バリアントではサポートされていません。サポートされているのは、Denodo、Drill、Snowflake のみです。

date の date_part を整数として返します。

週の始まりと見なす曜日を指定する start_of_week パラメーターはオプションです。考えられる値は「monday」、「tuesday」などです。start_of_week が省略されると、週の始まりはデータ ソースによって決定されます。詳細については、データ ソースの日付のプロパティを参照してください。

注: date_part が曜日の場合、start_of_week パラメーターは無視されます。これは、Tableauは固定した曜日順を信頼してオフセットを適用するためです。

ISO 8601 の日付をサポートしています。

例:

DATEPART('year', #2004-04-15#) = 2004
DATEPART('month', #2004-04-15#) = 4

指定された日付を date_part によって指定された精度で切り捨てます。この関数は新しい日付を返します。たとえば、月の中旬にある日付を月レベルで丸めた場合、この関数はその月の第 1 日を返します。週の始まりと見なす曜日を指定する start_of_week パラメーターはオプションです。考えられる値は「monday」、「tuesday」などです。start_of_week が省略されると、週の始まりはデータ ソースによって決定されます。詳細については、データ ソースの日付のプロパティを参照してください。

ISO 8601 の日付をサポートしています。

例:

DATETRUNC('quarter', #2004-08-15#) = 2004-07-01 12:00:00 AM
DATETRUNC('month', #2004-04-15#) = 2004-04-01 12:00:00 AM

指定された日付の日の部分を整数として返します。

例:

DAY(#2004-04-12#) = 12

指定された文字列が有効な日付の場合、true を返します。

例:

ISDATE("April 15, 2004") = true

指定した年、月、日から構成された日付値を返します。

Tableau Data Extract で利用できます。他のデータ ソースで利用可能か確認します。

例:

MAKEDATE(2004, 4, 15) = #April 15, 2004#

日付と時刻を組み合わせた日付時刻を返します。日付は、日付、日付時刻、または文字列の種類になることがあります。時刻は日付時刻である必要があります。

注: この関数は、MySQL 互換の接続 (Tableau では MySQL および Amazon Aurora) でのみ使用できます。

例:

MAKEDATETIME("1899-12-30", #07:59:00#) = #12/30/1899 7:59:00 AM#
MAKEDATETIME([Date], [Time]) = #1/1/2001 6:00:00 AM#

指定した時、分、秒から構成された日付値を返します。

Tableau Data Extract で利用できます。他のデータ ソースで利用可能か確認します。

例:

MAKETIME(14, 52, 40) = #14:52:40#

通常は数値に適用されますが、日付でも使用できます。a と b の最大値を返します (a と b は同じ型でなければなりません)。いずれかの引数が Null の場合は、Null を返します。

例:

MAX(#2004-01-01# ,#2004-03-01#) = 2004-03-01 12:00:00 AM
MAX([ShipDate1], [ShipDate2])

通常は数値に適用されますが、日付でも使用できます。a と b の最小値を返します (a と b は同じ型でなければなりません)。いずれかの引数が Null の場合は、Null を返します。

例:

MIN(#2004-01-01# ,#2004-03-01#) = 2004-01-01 12:00:00 AM
MIN([ShipDate1], [ShipDate2])

指定された日付の月の部分を整数として返します。

例:

MONTH(#2004-04-15#) = 4

現在のローカル システムの日付と時刻を返します。

例:

NOW( ) = 2004-04-15 1:08:21 PM

指定された日付の四半期の部分を整数として返します。

例:

WEEK (#2004-04-15#) = 16

現在の日付を返します。

例:

TODAY( ) = 2004-04-15

指定された日付の週の部分を整数として返します。

例:

WEEK (#2004-04-15#) = 16

指定された日付の年の部分を整数として返します。

例:

YEAR(#2004-04-15#) = 2004

指定された日付の ISO8601 週ベースの四半期の部分を整数として返します。

例:

ISOQUARTER (#2005-03-29#) = 2

指定された日付の ISO8601 週ベースの部分を整数として返します。

例:

ISOWEEK (#2004-03-29#) = 14

指定された日付の ISO8601 週ベースの曜日の部分を整数として返します。

例:

ISOWEEKDAY (#2004-03-29#) = 1