ai.date
ai.date 名前空間を使用すると、ユーザーは ISO8601 の日時文字列を作成したり、それらをさまざまなタイムゾーンに変換したりできるようになります。ISO8601 の詳細については、 こちらをご覧ください。
方法
| パラメータ
| 戻り値の型
| 説明
|
|---|---|---|---|
create( date, sourceTz, format) |
| String | 部分的な日時文字列、タイムゾーン、およびオプションのフォーマット文字列から、日付、時間、タイムゾーン オフセットを含む ISO8601 フォーマットの日時文字列を作成します。有効なフォーマット文字列のトークンは以下にあります。 重要: date が有効な ISO8601 文字列ではない場合、正常に解析して日付文字列を作成するためにフォーマット文字列を指定する必要があります。 |
convertTimezone( date, targetTz ) |
| String | JavaScript 日付オブジェクトまたは有効な ISO8601 日付文字列をあるタイムゾーンから別のタイムゾーンに変換します。戻り値は、ターゲット タイムゾーンでフォーマットされた ISO8601 の日付文字列です。タイムゾーンの有効な値を以下で確認できます。 |
getServerTimezone() | String | インテグレーション サーバーのタイムゾーンを返します。ユーザー スクリプトで作成された新しい日付オブジェクトは、サーバーのタイムゾーンのものとして扱われます。 | |
getSupportedTimezones() | Array<String> | convertTimezone() で使用されるすべての有効なタイムゾーンを含む配列を返します。 |
サポートされているタイムゾーン
アフリカ/アビジャン | America/Grand_Turk | アジア/アンマン | オーストラリア/北部 | ヨーロッパ/バドゥズ |
アフリカ/アクラ | アメリカ/グレナダ | アジア/アナドリル | オーストラリア/パース | ヨーロッパ/バチカン |
Africa/Addis_Ababa | アメリカ/グアドループ | アジア/アクタウ語 | オーストラリア/クインシーランド州 | ヨーロッパ/ウィーン |
アフリカ/アルジェリア | アメリカ/グアテマ | アジア/リクルーター | オーストラリア/南部 | ヨーロッパ/ビリニュス |
アフリカ/アスマラ語 | アメリカ/グアキー語 | アジア/アシガバート | オーストラリア/シドニー | ヨーロッパ/ボルト |
アフリカ/アローマ語 | アメリカ/ガイアナ | アジア/アシュカバード | オーストラリア/タスクソース | ヨーロッパ/ワルシャワ |
Africa/Bamako | America/Halifax | アジア/バグダッド | オーストラリア/ビクトリア州 | ヨーロッパ/ザグレブ |
アフリカ/バンギ語 | America/Havana | アジア/バーリン | オーストラリア/西部 | ヨーロッパ/ザポリシー |
アフリカ/バンジュール語 | America/Hermocillo | アジア/バクー | オーストラリア/Yancounna | ヨーロッパ/ジュリ語 |
アフリカ/ビサウ語 | アメリカ/インディアナ州/インディアナポリシー | アジア/銀行口座 | ブラジル/エーカー | GB |
アフリカ/ブランストーン | America/Indiana/Knox | アジア/ベイルート | ブラジル/DeNoronha | GB-Eire |
Africa/Brazzaville | アメリカ/インディアナ州/マレンゴ | アジア/ビシュケク語 | ブラジル/東部 | GMT |
アフリカ/ブ純ブラ | アメリカ/インディアナ州/ペテルブルグ | アジア/ブルネイ | ブラジル/西部 | GMT+0 |
アフリカ/カイロ | America/Indiana/Tell_City | アジア/カルカット | CET | GMT-0 |
アフリカ/Casablanca | アメリカ/インディアナ州/Vベイ | アジア/チタ語 | CST6CDT | GMT0 |
アフリカ/セウタ | アメリカ/インディアナ州/ビンセント | アジア/カスタマイズ | カナダ/大都市 | グリーンウィッシュ |
アフリカ/コンナックリ語 | アメリカ/インディアナ州/ウィナMac | アジア/重慶 | カナダ/中央 | HST |
アフリカ/ダカル | アメリカ/インディアナポリシー | アジア/チャンキング | カナダ/東部サスケワン州 | 香港 |
Africa/Dar_es_Salaam | アメリカ/イヌブク語 | アジア/コロンボ | カナダ/東部 | アイスランド |
アフリカ/ジブチ | America/Iqaluit | アジア/ダッカ | カナダ/Mountain | インディアン/アンアナリボ |
アフリカ/ドゥアラ | アメリカ/ジャマイカ | アジア/ダマスコ | カナダ/ニューファンドランド | インディアン/チャゴス語 |
Africa/El_Aaiun | America/JuJuy | アジア/ダッカ | カナダ/太平洋地域 | インディアン/教会 |
アフリカ/自由都市 | アメリカ/ジュオー | アジア/ディル語 | カナダ/サスカチュワン州 | インディアン/コースト |
アフリカ/ガボロン | アメリカ/ケンタッキー州/ルービル | アジア/ドバイ | カナダ/ユーコン準州 | インディアン/コモロ |
アフリカ/ハラレ | アメリカ/ケンタッキー州/モンティセロ | アジア/Dun Plane | チリ/西部 | インディアン/ケルゲール語 |
Africa/Johannesburg | America/Knox_IN | Asia/Gaza | チリ/EasterIsland | インディアン/マーヘ語 |
アフリカ/ジュバ | America/Kralendisk | アジア/ハービン | キューバ | インド/モルディブ |
アフリカ/カンパラ州 | America/La_Paz | アジア/ヘブライ語 | EET | インディアン/モーリシャス |
アフリカ/シャルルサム | America/リマ州 | Asia/Ho_Chi_Minh | EST | インディアン/マイロット |
アフリカ/キガ語 | America/Los_Angeles | Asia/Hong_Kong | EST5EDT | インディアン/レユニオン |
アフリカ/キンシャサ | アメリカ/ルービル | アジア/ホビデオ | 予算 | イラン |
アフリカ/ラゴス | America/Lower_Prences | アジア/リクルーター | エイレ | イスラエル |
アフリカ/リーブル | America/Maceio | アジア/イスタンブール | Etc/GMT | ジャマイカ |
アフリカ/ローマ字表記 | アメリカ/マン語 | アジア/ジャカルタ | Etc/GMT+0 | 日本 |
アフリカ/ルンダ | America/Manaus | アジア/ジャヤプラ | Etc/GMT+1 | クワジャリン |
アフリカ/ルンバシ | America/Marigo | アジア/エルサレム | Etc/GMT+10 | リビア |
アフリカ/ルサカ | アメリカ/マルティニーク | アジア/カブール | Etc/GMT+11 | MET |
アフリカ/マラボ | America/Matamors | アジア/カムチャツカ語 | Etc/GMT+12 | MST |
アフリカ/マプト | America/マサトラン | アジア/カラチ | Etc/GMT+2 | MST7MDT |
アフリカ/マセル | アメリカ/メンドーサ | Asia/Kashgar | Etc/GMT+3 | メキシコ/バハマ |
アフリカ/ムババン | アメリカ/メンター | アジア/カトマンズ | Etc/GMT+4 | メキシコ/バハマ |
アフリカ/モガディシュ語 | America/Merid | アジア/カトマンズ語 | Etc/GMT+5 | メキシコ/一般 |
アフリカ/モンロビア | アメリカ/メトラカットラ | アジア/カンディガ | Etc/GMT+6 | NZ |
アフリカ/ナイロビ | America/Mexico_City | アジア/コルカタ | Etc/GMT+7 | NZ-CHAT |
アフリカ/ンジャメナ語 | America/Mikelon | アジア/クラスノヤルスク | Etc/GMT+8 | Navajo |
アフリカ/ニアメトリック | アメリカ/モンクトン | Asia/Kuala_Lumpur | Etc/GMT+9 | PRC |
アフリカ/ヌクショット | America/Montry | アジア/クチン | Etc/GMT-0 | PST8PDT |
アフリカ/ワガドウ語 | America/Montevid | アジア/クウェート | Etc/GMT-1 | 太平洋/アピア |
アフリカ/ポートフォリオ州 | America/Montreal | アジア/マカオ | Etc/GMT-10 | 太平洋/エーカーランド |
Africa/Sao_Tome | America/Montserrat | アジア/マカオ | Etc/GMT-11 | 太平洋/ブレークダウン |
アフリカ/ティムクツ語 | America/Nassau | アジア/マガダン | Etc/GMT-12 | 太平洋/チャタム語 |
アフリカ/トリポリシー | America/New_York | アジア/マカサール | Etc/GMT-13 | 太平洋/キューク諸島 |
アフリカ/チュニジア | アメリカ/ニピオン | アジア/Manila | Etc/GMT-14 | 太平洋/東部 |
アフリカ/ウィンドウホック | アメリカ/ノーム | アジア/マスカット | Etc/GMT-2 | 太平洋/東部 |
America/Adak | America/Noronha | アジア/ニックネーム | Etc/GMT-3 | 太平洋/エンターベイ |
America/AnchoRage | America/North_Dakota/Beulah | アジア/ノヴォクズネツク | Etc/GMT-4 | パシフィック/ファカオ |
アメリカ/アンギラ | America/North_Dakota/Center | アジア/ノヴォシビルスク | Etc/GMT-5 | 太平洋/フィジー |
アメリカ/アンティグア | America/North_Dakota/New_Salem | アジア/オンスク | Etc/GMT-6 | 太平洋/カリフォルニア州 |
アメリカ/アラガイナ語 | America/OJNag | アジア/口頭 | Etc/GMT-7 | 太平洋/ガラパゴス |
アメリカ/アルゼンチン/ブエノスアイレス | アメリカ/パナマ語 | Asia/Phnom_Penh | Etc/GMT-8 | 太平洋/ガンビア |
アメリカ/アルゼンチン/補償範囲 | America/Pangurtong | アジア/Pontianak | Etc/GMT-9 | 太平洋/湾岸地域 |
America/Argentina/ComodRivadavia | アメリカ/パラマリーボ | アジア/ピッキング | Etc/GMT0 | 太平洋/グアム |
アメリカ/アルゼンチン/コルドバ語 | America/Phoenix | アジア/カタール | Etc/Greenwich | 太平洋/ホノルル |
アメリカ/アルゼンチン/フフイ | アメリカ/ポルトガル プラン | アジア/Qy済ロールダ | ETC/UCT | 太平洋/Johnston |
America/Argentina/La_Rioja | America/Port_of_Spain | アジア/ラングーン | Etc/UTC | 太平洋/島国 |
アメリカ/アルゼンチン/メンドーサ | America/Porto_Acre | アジア/リヤド | ETC/汎用 | パシフィック/コラーサ語 |
America/アルゼンチン/リオ ガレゴ | America/Porto_Velho | アジア/サイゴン | ETC/ズールー語 | 太平洋/クワジャリン |
アメリカ/アルゼンチン/サルタ | America/Pueto_Rico | アジア/サハリン | ヨーロッパ/アムステルダム | 太平洋/マジュロ語 |
アメリカ/アルゼンチン/san_Juan | America/Rainy_River | アジア/サマルカンド | ヨーロッパ/アンドラ | 太平洋/マーケサ語 |
アメリカ/アルゼンチン/san_luis | America/Rankin_Inlet | アジア/ビルマ語 | ヨーロッパ/アテネ | 太平洋/中空 |
アメリカ/アルゼンチン/チュクマン語 | America/Recipe | アジア/香港 | ヨーロッパ/ベルファスト | 太平洋/ナウル |
アメリカ/アルゼンチン/ウシュア語 | America/レジャイナ | アジア/シンガポール | ヨーロッパ/ベオグラード | 太平洋/ニューウェー |
America/Aruba | America/Resolution | エイリアス/スレ状 | ヨーロッパ/ベルリン | 太平洋/ノルウェー語 |
America/Asunion | America/Rio_Branco | アジア/台北 | ヨーロッパ/ブラチスラバ | 太平洋/ヌメア |
USA/アトリコカン | America/Rosaio | アジア/タシュケント | ヨーロッパ/ブリュッセル | Pacific/Pago_Pago |
America/Atca | America/Santta_Isabel | アジア/トビリシ | ヨーロッパ/ブカテスト | 太平洋/パラオ |
アメリカ/ベイア語 | America/算入 | アジア/テヘラン | ヨーロッパ/ブダペスト | 太平洋/ピトケアン |
America/Bahia_Banderas | アメリカ/サンティアゴ | Asia/Tel_Aviv | ヨーロッパ/ブエンジン | 太平洋/ポンドペイ |
アメリカ/バルバドス | America/Santo_Domingo | アジア/トンブ語 | ヨーロッパ/中国 | パシフィック/ポイント |
America/Belm 社 | America/Sau_Paulo | アジア/タンプー語 | ヨーロッパ/コペンハーゲン | Pacific/Port_Moresby |
アメリカ/ベリーズ | アメリカ/スコア基準 | アジア/台帳 | ヨーロッパ/ダブリン | 太平洋/ラロトンガ語 |
America/ブランサブロン | America/出荷ロック | Asia/Ujung_Pandang | ヨーロッパ/ジブラルタル | 太平洋/サイパン |
America/Boa_Vister | アメリカ/シトカ語 | アジア/ウランバートル | ヨーロッパ/ガベージオン | 太平洋/サモア |
アメリカ/ボゴタ | America/St_Barthelemy | アジア/Ulan_Bator | ヨーロッパ/ヘルシンキ | 太平洋/タヒチ |
America/Boise | America/St_Johns | アジア/ウルムチ | Europe/Isle_of_Man | 太平洋/タワ軍 |
America/buenos_aires | America/St_Kitts | アジア/米国 | ヨーロッパ/イスタンブール | パシフィック/トンガプション |
America/Cambridge_Bay | America/St_Lucia | アジア/ビエンチャン | ヨーロッパ/ジャーニー | 太平洋/トラック |
America/Campo_Grande | America/St_Thomas | アジア/ウラジオストク | ヨーロッパ/カリングラード | 太平洋/ウェーク航空 |
America/カンクン | America/St_Vincent | アジア/ヤクツク | ヨーロッパ/キエフ | 太平洋/ワリス語 |
America/Caracas | America/Swift_Current | アジア/エカテリンブルグ | ヨーロッパ/リスボン | パシフィック/ヤプ語 |
America/Catalog | アメリカ/テグシガルパ | アジア/セレバン | ヨーロッパ/リュブリジャーナ | ポーランド |
America/カイエンヌ語 | アメリカ/木曜日 | Atlantic/アゾレス諸島 | ヨーロッパ/ロンドン | ポルトガル |
America/ケイマン語 | America/Thunder_Bay | 大転換/バミューダ | ヨーロッパ/ルクセンブルグ | ROC |
アメリカ/シカゴ | アメリカ/ティファナ | アトラント/カナダ | ヨーロッパ/マドリード | ROK |
アメリカ/チワワ | America/Toronto | Atlantic/Cape_Verde | ヨーロッパ/マルタ | シンガポール |
America/Coral_Harbour | America/Totorola | アトランティック/フェロー | ヨーロッパ/マリーハム | トルコ |
America/Cordba | America/Vancouver | アトランティック/フェロー | ヨーロッパ/ミンスク | UCT |
America/Costa_Rica | アメリカ/バージン | Atlantic/Jan_Mayen | ヨーロッパ/モナコ | 米国/アラスカ州 |
America/Creston | America/ Whitehose | Atlantic/Madeira | ヨーロッパ/モスク | 米国/ア単位語 |
America/クイアバ語 | アメリカ/ウィニペグ | Atlantic/Reykjavik | ヨーロッパ/ニックネーム | 米国/アリゾナ州 |
アメリカ/キュラソー語 | America/ヤクタ | Atlantic/South_Georgia | ヨーロッパ/オスロ | 米国/中央 |
America/DanmarkShavn | アメリカ/Yellowknife | Atlantic/St_Helena | ヨーロッパ/パリ | 米国/東インディアナ州 |
America/Davis | 南極点/Casey | アトランティック/スタンリー | ヨーロッパ/ポドゴルイカ | 米国/東部 |
America/Dawson_Creek | 南極点/Davis | オーストラリア/ACT | ヨーロッパ/プラハ | 米国/ハワイ州 |
America/Denver | 南極点/DupmontDurvid | オーストラリア/アデレード | ヨーロッパ/リガ | 米国/インディアナ州スターク |
アメリカ/デトロイト | 南極点/マックエリー | オーストラリア/ブリスベン | ヨーロッパ/ローマ | 米国/ミシガン州 |
アメリカ/ドミニカ国 | 南極点/Mawson | オーストラリア/Broken_Hill | ヨーロッパ/サマリ | US/Mountain |
America/Edmonton | 南極点/McMurdo | オーストラリア/カリフォルニア州 | Europe/San_Marino | 米国/太平洋地域 |
America/Eirunepe | 南極点/パーマー語 | オーストラリア/通貨 | ヨーロッパ/サラエボ | 米国/太平洋-新 |
America/El_Salvador | 南極点/ロザ | オーストラリア/ダーウィン | ヨーロッパ/シンフェロール | 米国/サモア |
アメリカ/エンセナダ | Antarctica/South_Pole | オーストラリア/Eucレーション | ヨーロッパ/スコピエ | UTC |
America/Fort_Nelson | 南極/相和 | オーストラリア/ホバート | ヨーロッパ/ソフィア | 汎用 |
America/Fort_Wayne | 南極/トロール | オーストラリア/LHI | ヨーロッパ/ストックホルム | W-SU |
America/Fortalezu | 南極点/トランスポーター | オーストラリア/Lindeman | ヨーロッパ/タリン | WET |
America/Glace_Bay | 北極/ロングエイビエン | Australia/Lord_Howe | ヨーロッパ/アジア | ズールー語 |
America/godthab | アジア/アーデン | オーストラリア/メルボルン | ヨーロッパ/ティラプール | |
America/Goose_Bay | アジア/アルマトイ | オーストラリア/NSW | ヨーロッパ/ウズゴロド |
サポートされている日付フォーマット文字列トークン
英数字以外の文字は、解析によって無視されます。
- 年、月、日のトークン
- 入力例説明YYYY20144 桁または 2 桁の年YY142 桁の年Q1..4四半期月を四半期の最初の月に設定します。M MM1..12月数MMM MMMM1 月.12 月ロケールの月名D DD1..31月の通算日許可事項1 ~ 31 日月の日付DDD DDDD1..365年の通算日X1410715640.579Unix タイムスタンプx1410715640579Unix ms タイムスタンプバージョン 2.10.5 の YYYY は 2 桁の年をサポートしており、2000 年 (YY と同じ) に近い年に変換されます。
- 週の年、週、曜日のトークン
- この場合、小文字のトークンではロケール対応の週の開始日を使用し、大文字のトークンでは ISO の週の 日付の開始日を使用します。入力例説明gggg2014ロケール 4 桁の週の年gg14ロケール 2 桁の週の年w ww1..53ロケールの週e1..7ロケールの曜日ddd dddd月曜日...日曜日ロケールの曜日名GGGG2014ISO 4 桁週数GG14ISO 2 桁週数W WW1..53年の ISO 週E1..7ISO 曜日
- 時間、分、秒、ミリ秒、オフセット トークン
- 入力例説明H HH0..2324 時間単位H H1..12A で 12 時間使用。a Aam pmメリット給の計上m mm0..59分数s s0..59秒S SS SSS0..999分数で表された秒Z ZZ+12:00UTC からのオフセット (+-HH:mm、+-HHmm、または Z)
ISO8601 日時文字列の作成
// create a date from a date fragment that is in ISO8601 format var date = ai.date.create('2016-02-01', 'America/Los_Angeles'); // date is "2016-02-01T00:00:00-08:00" // create a date from a date fragment that is NOT in ISO8601 format var date = ai.date.create('02/01/2016', 'America/Los_Angeles', 'MM/DD/YYYY'); // date is "2016-02-01T00:00:00-08:00" // create a date from a date fragment that is NOT in ISO8601 format, but in Australian format var date = ai.date.create('02/01/2016', 'America/Los_Angeles', 'DD/MM/YYYY'); // date is "2016-01-02T00:00:00-08:00" // create a date from a date and time fragment, but no offset, fragment is in ISO8601 format. var date = ai.date.create('2016-02-01T05:00', 'America/Los_Angeles'); // date is "2016-02-01T05:00:00-08:00" var date = ai.date.create('2016-02-01 05:00', 'America/Los_Angeles'); // date is "2016-02-01T05:00:00-08:00" // create a date that includes daylight savings var date = ai.date.create('2016-02-01 12:00', 'Australia/Sydney'); // date is "2016-02-01T12:00:00+11:00" // without daylight savings... var date = ai.date.create('2016-06-01 12:00', 'Australia/Sydney'); // date is "2016-02-01T12:00:00+10:00" // create a date in UTC var date = ai.date.create('2016-03-01', 'UTC'); // date is "2016-03-01T00:00:00+00:00"
ISO8601 日時文字列の変換
// convert Brisbane to Sydney time with daylight savings var date = ai.date.convertTimezone(new Date('2015-01-15T12:00:00+10:00'), 'Australia/Sydney'); // date is "2015-01-15T13:00:00+11:00" // convert Brisbane to Sydney time without daylight savings var date = ai.date.convertTimezone('2015-06-15T12:00:00+10:00', 'Australia/Sydney'); // date is "2015-06-15T12:00:00+10:00" // convert Brisbane to New York time var date = ai.date.convertTimezone('2015-06-15T12:00:00+10:00', 'America/New_York'); // date is "2015-06-14T22:00:00-04:00" // convert New York to Brisbane time var date = ai.date.convertTimezone('2015-06-15T12:00:00-04:00', 'Australia/Brisbane'); // date is "2015-06-16T02:00:00+10:00" // convert New York to UTC time var date = ai.date.convertTimezone('2015-06-15T12:00:00-04:00', 'UTC'); // date is "2015-06-15T16:00:00+00:00"
サーバーのタイムゾーンを取得
var serverTz = ai.date.getServerTimezone(); // as an example, serverTz = 'America/Los_Angeles'
サポートされているすべてのタイムゾーンの取得
var timezones = ai.date.getSupportedTimezones(); // timezones is an array containing the above 583 timezones