式エディタで日付/時刻関数を使用して、日付と時刻の値を作成、操作、書式設定します。
AlteryxはISO形式yyyy-mm-dd HH:MM:SSを使用して日付と時刻を表します。 日付/時刻の値がこの形式でない場合、Alteryxはそれを文字列として読み込みます。 日付/時刻形式で使用および操作用の列を変換するには、式エディタのDateTimeParse関数または日時ツールを使用します。
日付/時刻関数は、不正な入力が与えられた場合、日付が予想される形式と一致しない場合、または日付が無効な場合に変換エラーを報告します。
文字列データをネイティブの日付/時刻形式(yyyy-mm-dd HH:MM:SS)または日付/時刻データを別の形式に変換します。
任意の形式の日付/時刻文字列データを、Alterxが使用できる形式(yyyy-mm-dd HH:MM:SS)に変換します。
dt:選択した列または引用符の間の日付/時刻文字列として表される日付/時刻文字列データ。 着信データは文字列データ型である必要があり、この形式がfパラメータで指定した形式と一致する限り、日付/時刻の任意の形式にすることができます。
f:引用符の間で形式文字列で表される、変換しているデータの形式。
DateTimeParse("2016/28-03","%Y/%d-%m") は、2016-03-28(出力データ型が文字列または日付の場合)または2016-03-28 00:00:00(出力データ型が日付時刻の場合)を返します。 形式文字列 "%Y /%d-%m" は、着信日付/時刻データの形式をAlteryxに伝えます。 次に、Alteryxはこの値をISOの日付/時刻形式に変換します。
DateTimeFormat(dt,f)
日付/時刻データ(ネイティブ/ ISO形式)を別のアプリケーションで使用する形式に変換します。 日付または日付時刻ではなく、文字列データ型に出力する必要があることに注意してください。
DateTimeFormat([DateTime_Out],"%d-%m-%Y") は、April 22, 2008の日付で22-04-2008を返します(ISO形式: 2008-04-22)。
現在の日付、時刻、および月のバリアントを返します。
DateTimeNow()
現在のシステムの日付と時刻を返します。
DateTimeStart()
現在のワークフローの実行が開始された日付と時刻を返します。
DateTimeToday()
今日の日付を返します。 時刻は、1日の始まりの真夜中に設定されます。
DateTimeFirstOfMonth()
真夜中の現在の月の最初の日を返します。
DateTimeLastOfMonth()
現在の月の最終日を返します。時計はその日の終わりの1秒前(23:59:59)に設定されます。
Alteryxは、式が最初に解析された日付と時刻を使用します。 バッチプロセスでは、この時刻は新しいデータセットごとに使用されます。 これにより、処理に時間がかかる場合に一貫性を可能にします。
日付時刻値の指定されたコンポーネントを返します。
DateTimeMonth(dt)
日付時刻値の月の数値を返します。
dt:選択された列または引用符間の指定された日付/時刻値として表される日付/時刻データ。
DateTimeMonth("2017-03-24 11:43:23") 3を返します。
DateTimeMonth("11:43:23") 着信データが有効でないため、[Null]を返します。
DateTimeDay(dt)
日付時刻の月の日の数値を返します。
dt:選択された列または引用符間の指定された日付/時刻値として表される日付/時刻データ。
DateTimeDay("2017-03-24 11:43:23") 24を返します。
DateTimeYear(dt)
日付時刻値の年の数値を返します。
dt:選択された列または引用符間の指定された日付/時刻値として表される日付/時刻データ。
DateTimeYear("2017-03-24 11:43:23") 2017を返します。
DateTimeHour(dt)
時刻の時間部分を日付時刻値で返します。
dt:選択された列または引用符間の指定された日付/時刻値として表される日付/時刻データ。
DateTimeHour("2017-03-24 11:43:23") 11を返します。
DateTimeHour("2017-03-24") 真夜中は日付付きで時刻が指定されていない場合の想定される時間であるため、0を返します。
指定した期間で日付/時刻の値を修正したり、2つの日付/時刻の値の差を取得したり、日付/時刻の値の不要な部分を削除したりします。
DateTimeAdd(dt,i,u)
指定された時刻の期間で所定の日付/時刻を修正します。
dt:選択された列または引用符間の指定された日付/時刻値として表される日付/時刻データ。
i:加算または減算する正または負の整数の時刻。
u:引用符間の指定された日付/時刻単位: 年、月、日、時、分、秒のいずれかです。
DateTimeAdd (DateTimeToday(), -1, ”days”) 昨日の日付を返します。
DateTimeAdd(DateTimeFirstOfMonth(), 1, ”months”) 次の月の最初を返します。
DateTimeAdd(“2016-01-30”, 1, “month”) 2016-02-29を返します(2月には30日がないため)。
DateTimeAdd(“2016-03-30”, -1, “month”) 2016-02-29を返します(2月には30日がありませんが、その最後の日は29日であるため)。
DateTimeDiff(dt1,dt2,u)
最初の引数から2番目の引数を減算し、整数の差として返します。 期間は、指定された単位で、文字列ではなく数として返されます。
dt1:選択された列または引用符間の指定された日付/時刻値として表される日付/時刻データ。
dt2:選択された列または引用符間の指定された日付/時刻値として表される、dt1から減算する日付/時刻データ。
u:引用符間の指定された日付/時刻単位: 年、月、日、時、分、秒のいずれかです。
DateTimeDiff("2012-02-29","2011-03-01","years") 0を返します(2012-02-29は2011-03-01の365日後ですが、2月29日は3月1日より前なので、"1年" はまだ完了していません)。
DateTimeDiff(“2016-02-14”, “2016-01-15”, “Months”) 0を返します(2月の日付が1月の日付よりも小さいためです)。
DateTimeDiff(“2016-02-14 23:59:59”, “2016-01-15 00:00:00”, “Months”) 0を返します(必要な1日にわずか1秒満たない場合でも)。
DateTimeDiff(“2016-02-15 00:00:00”, “2016-01-15 00:00:01”, “Months”) 1を返します(開始日と終了日がその月の同じ日付になるため)。
DateTimeDiff(‘2017-02-28’, ‘2016-02-29’, ‘Months’) 11を返します(28日は2017年の2月の最終日ですが、28は29未満です)。
DateTimeDiff('2016-01-01 00:59:59'、'2016-01-01 00:00:00'、'Hours')は0です。
DateTimeDiff('2016-01-01 23:59:59'、'2016-01-01 00:00:00'、'Days')は0です。
DateTimeTrim(dt,t)
日付/時刻の不要な部分を削除し、修正した日付/時刻を返します。
dt:選択された列または引用符間の指定された日付/時刻値として表される日付/時刻データ。
t:トリムタイプ。 オプションには以下が含まれます:
日付/時刻をトリムしても返される値は四捨五入されません。 例えば、時にトリムされた時刻15:59:59は、16:00:00ではなく15:00:00になります。
DateTimeTrim("2016-12-07 16:03:00","year") 2016-01-01 00:00:00を返します。
日付時刻列をUTC(協定世界時)または現地時刻に変換します。
DateTimeToLocal(dt)
UTC日付時刻列を現地システムのタイムゾーンに変換します。
dt:選択された列または引用符間の指定された日付/時刻値として表される日付/時刻データ。
DateTimeToLocal('2014-08-01 20:01:25') 2014-08-01 14:01:25として現地システムのタイムゾーン(山岳部時間)を返します。
DateTimeToUTC(dt)
日付時刻を現地システムのタイムゾーンでUTCに変換します。 多くのウェブAPIでは、日付ベースのクエリが可能で、頻繁にUTCの時刻にする必要があります。
dt:選択された列または引用符間の指定された日付/時刻値として表される日付/時刻データ。
DateTimeToUTC(DateTimeNow()) ワークフロー実行時に協定世界時を返します: 2014-08-01 20:01:25(現地の山岳部時間は2014-08-01 14:01:25でした)。
日付/時刻の形式文字列は、DateTimeParseおよびDateTimeFormat関数によって使用され、Alterxに日付/時刻値を解析(読み込み)または書式設定(書き込み)する方法を伝えます。 形式文字列は、指定子と区切り文字で構成されます。
指定子は常にパーセント記号(%)で始まり、大文字と小文字が区別されます。 データには少なくとも2桁の年が含まれる必要があります。
指定子 | DateTimeFormatからの出力 | DateTimeParseでサポートされる入力 |
---|---|---|
%a | 短縮された曜日名( "Mon") | 所定のテキストが曜日でない場合にのみエラーを生成する曜日の有効な省略形("mon"、"Tues"、"Thur")。 Alteryxは、指定された曜日名が特定の日付に対して有効であることを確認しません。 |
%A | 完全な曜日名("Monday") | 所定のテキストが曜日でない場合にのみエラーを生成する曜日名または曜日の有効な省略形("mon"、"Tues"、"Thur")。 Alteryxは、指定された曜日名が特定の日付に対して有効であることを確認しません。 |
%b | 短縮月名("Sep") | 所定のテキストが月の名前でない場合にのみエラーを生成する月名の有効な省略形("Sep"、"SEPT.")。 |
%B | 完全な月名("September") | 所定のテキストが月の名前でない場合にのみエラーを生成する月名または月名の有効な省略形("Sep"、"SEPT.")。 |
%c | コンピュータのロケールの日付と時刻 | サポートされていません |
%C | 世紀番号("20") | サポートされていません |
%d | 月の日("01") | スペースを無視して1桁または2桁("1" または "01") |
%D | %m/%d/%yと同等です | サポートされていません |
%e | 月の日、先頭の0をスペース("1")で置き換えます。 | スペースを無視して1桁または2桁("1" または "01") |
%h | %bと同じです("Sep") | 所定のテキストが月の名前でない場合にのみエラーを生成する月名の有効な省略形("Sep"、"SEPT.")。 |
%H | 24時間制での時、00~23 | 時は2桁まで、0~23。 %pまたは%Pとの互換性はありません。 |
%I (大文字 "eye") |
12時間制での時、01~12 | 時は2桁まで、1~12。 %pまたは%Pに従う必要があります。 |
%j | 年の日、001~365(またはうるう年では366) | 年の3桁の日、001~365(またはうるう年では366) |
%k | 24時間、先頭の0はスペース、" 0" から "23" | 時は2桁まで |
%l (小文字の "ell") |
12時間、先頭の1はスペース、" 0" から "12" | サポートされていません |
%M | 分、00~59 | 分は2桁まで |
%m | 月の数、01~12 | 1桁または2桁の月の数、1または01~12 |
%p | "AM" または "PM" | 大文字と小文字を区別しない( "aM" または "Pm")。 %Iに従う必要があります (大文字の "eye"、12時間形式での時) |
%P | "am" または "pm" | 大文字と小文字を区別しない( "aM" または "Pm")。 %Iに従う必要があります (大文字の "eye"、12時間形式での時) |
%S | 秒、00~59 | 秒は2桁まで |
%T | 24時間表記の時刻。 %H:%M:%Sに相当します | サポートされていません |
%u | 10進数での曜日、1~7、月曜日は1 | サポートされていません |
%U | これは、00~53として週の数を週の始まりを日曜日として返します。 | サポートされていません |
%w | 数での曜日、0~6、月曜日は0 | サポートされていません |
%W | これは、00~53として週の数を週の始まりを月曜日として返します。 | サポートされていません |
%x | コンピュータのロケールの日付 | サポートされていません |
%X | AMまたはPMを含む12時間制での時刻(“11:51:02 AM”) | 時:分:秒 [AM / PM] |
%Y | 年の最後の2桁("16") | 最大4桁の数字が読み込まれ、区切り文字または文字列の最後で停止し、現在の年マイナス66から現在の年プラス33までの範囲にマッピングされます(例えば、2016年では、それは1950年から2049年です)。 |
%Y | 年のすべての4桁("2016") | 2桁または4桁の数字が読み込まれます。 2桁の数字が現在の年マイナス66から現在の年プラス33までの範囲にマッピングされます(例えば、2016年では、それは1950年から2049年です)。 |
%Z | UTC時刻からのオフセット("-600") | サポートされていません |
%Z | フルタイムゾーン名("Mountain Daylight Time") | サポートされていません |
セパレータは日付/時刻指定子の間に挿入され、形式文字列を形成します。
セパレータ | DateTimeFormatからの出力 | DateTimeParseでサポートされる入力* |
---|---|---|
/ | / | /または - |
- | - | /または - |
スペース | スペース | 任意の一連の空白類文字 |
%n | 改行 | サポートされていません |
%t | タブ | サポートされていません |
その他 | コンマ、ピリオド、コロンなどのその他の文字 | コンマ、ピリオド、コロンなどのその他の文字 |
形式文字列 | 結果 |
---|---|
%d-%b-%y | 01-Aug-16 |
%A, %d %B, %Y | Monday, 01 August, 2016 |
%d-%m-%y | 01-08-16 |
%d-%m-%Y | 01-08-2016 |
%d %B, %Y | 01 August, 2016 |
%d/%m/%y | 2016/01/08 |
%d/%m/%Y | 2016/01/08 |
%a, %B %d, %Y | Mon, August 01, 2016 |
%A, %B%e, %Y | Monday, August 1, 2016 |
%m-%d-%y | 08-01-16 |
%m-%d-%Y | 08-01-2016 |
%m/%d/%y | 08/01/16 |
%m/%d/%Y | 08/01/2016 |
%b %d | Aug 01 |
%B %d, %Y | August 01, 2016 |
%B, %Y | August, 2016 |
%Y-%m-%d | 2016-08-01 |
%Y%m%d | 20160801 |
© Alteryx, Inc All Rights Reserved Allocate®、Alteryx®、 Guzzler®、Solocast®はAlteryx, Inc.の登録商標です。