Intl.DateTimeFormat【国際化日時フォーマット】コンストラクタ・プロパティ・メソッド
new Intl.DateTimeFormat【コンストラクタ】
format【フォーマット関数】
formatRange【範囲フォーマット】
formatRangeToParts【範囲フォーマットパーツ取得】
formatToParts【フォーマットパーツ取得】
resolvedOptions【オプション取得】
supportedLocalesOf【サポート ロケール取得】
new Intl.DateTimeFormat【コンストラクタ】
メモ
概要
- Intl.DateTimeFormat【国際化日時フォーマット】 オブジェクトを生成
- format【フォーマット関数】で文字列に変換
- 数字・表現形式・タイムゾーン 等の指定が可能
関連
外部リンク
- ECMA-402 (英語)
Intl.DateTimeFormat([ locales [, options ]]) ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9) InitializeDateTimeFormat (dateTimeFormat, locales, options) ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9) - RFC 5646:Tags for Identifying Languages (英語)
- RFC 4647:Matching of Language Tags (英語)
- IANA:Time Zone Database (英語)
構文
new Intl.DateTimeFormat([locales [, options]])
Intl.DateTimeFormat【国際化日時フォーマット】 オブジェクト
localesロケール (BCP 47 の言語タグ等 + 各種拡張フォーマット)〔実装依存〕
省略:デフォルトのロケール〔実装依存〕
文字列:1ロケール指定
文字列の配列:複数指定可 (適切な1ロケールを自動選択)
optionsオプション (実装依存)
locales (ロケール - 言語タグ) 実装依存
BCP 47 の言語タグ (一例)
値 | 備考 |
---|---|
ja | 日本語 |
ja-JP | 日本語 (日本) |
en-US | 英語 (アメリカ) |
en-GB | 英語 (イギリス) |
de-DE | ドイツ語 (ドイツ) |
fr-FR | フランス語 (フランス) |
ISO 639-1・639-2 (言語コード) 一例
ISO 639-1 | ISO 639-2 | ISO 639-3 | 備考 |
---|---|---|---|
ja | jpn | jpn | 日本語 |
en | eng | eng | 英語 |
de | deu ger | deu | ドイツ語 |
fr | fra fre | fra | フランス語 |
Unicode 拡張 数値フォーマット 実装依存
値 (-u-nu-○) | 備考 | 例 | コード |
---|---|---|---|
arab | アラビア・インド数字 | ٩ ~ ٠ | U+0660 ~ U+0669 |
arabext | ペルシア数字 | ۰ ~ ۹ | U+06F0 ~ U+06F9 |
bali | バリ数字 | ― | U+1B50 ~ U+1B59 |
beng | ベンガル数字 | ০ ~ ৯ | U+09E6 ~ U+09EF |
deva | デーヴァナーガリー数字 | ० ~ ९ | U+0966 ~ U+096F |
fullwide | 全角数字 | 0 ~ 9 | U+FF10 ~ U+FF19 |
gujr | グジャラート数字 | ૦ ~ ૯ | U+0AE6 ~ U+0AEF |
guru | グルムキー数字 | ੦ ~ ੯ | U+0A66 ~ U+0A6F |
hanidec | 漢数字 | 〇 ~ 九 | U+3007, U+4E00, U+4E8C, U+4E09, U+56DB, U+4E94, U+516D, U+4E03, U+516B, U+4E5D |
khmr | クメール数字 | ០ ~ ៩ | U+17E0 ~ U+17E9 |
knda | カンナダ数字 | ೦ ~ ೯ | U+0CE6 ~ U+0CEF |
laoo | ラオ数字 | ໐ ~ ໙ | U+0ED0 ~ U+0ED9 |
latn | 算用数字 (アラビア数字) | 0 ~ 9 | U+0030 ~ U+0039 |
limb | リンブ数字 | ― | U+1946 ~ U+194F |
mlym | マラヤーラム数字 | ൦ ~ ൯ | U+0D66 ~ U+0D6F |
mong | モンゴル数字 | ᠐ ~ ᠙ | U+1810 ~ U+1819 |
mymr | ミャンマー数字 | ၀ ~ ၉ | U+1040 ~ U+1049 |
orya | オリヤー数字 | 뙦 ~ 뙯 | U+0B66 ~ U+0B6F |
tamldec | タミル数字 | ௦ ~ ௯ | U+0BE6 ~ U+0BEF |
telu | テルグ数字 | ౦ ~ ౯ | U+0C66 ~ U+0C6F |
thai | タイ数字 | ๐ ~ ๙ | U+0E50 ~ U+0E59 |
tibt | チベット数字 | ༠ ~ ༩ | U+0F20 ~ U+0F29 |
Unicode 拡張 暦フォーマット 実装依存
値 (-u-ca-○) | 備考 |
---|---|
buddhist | タイ仏教暦 |
chinese | 中国暦 |
coptic | コプト暦 |
ethioaa | ダンギ暦 |
ethiopic | エチオピア暦 |
gregory | グレゴリオ暦 (西暦) |
hebrew | ユダヤ暦 |
indian | インド国定暦 |
islamic | イスラム暦 (1) |
islamicc | イスラム暦 (2) |
iso8601 | ISO 8601 |
japanese | 和暦 |
persian | ペルシア暦 |
roc | 中華民国暦 |
Unicode 拡張 時間形式フォーマット 実装依存
値 (-u-hc-○) | 備考 |
---|---|
h11 | 12 時間形式 (0 ~ 11) |
h12 | 12 時間形式 (1 ~ 12) |
h23 | 24 時間形式 (0 ~ 23) |
h24 | 24 時間形式 (1 ~ 24) |
options (オプション) 実装依存
オプション | 値 (太字:デフォルト値) | 備考 |
---|---|---|
全般 | ||
localeMatcher | 'lookup':Lookupアルゴリズム 'best fit':最適アルゴリズム | ロケールマッチングアルゴリズム |
formatMatcher | 'basic':Basicアルゴリズム 'best fit':最適アルゴリズム | 書式マッチングアルゴリズム |
calendar | Unicode 拡張 暦フォーマット | 暦フォーマット |
numberingSystem | Unicode 拡張 数値フォーマット | 数値フォーマット |
タイムゾーン関連 | ||
timeZone | UTC ・ 'Asia/Tokyo' ・ 'America/New_York' 等 | タイムゾーン (IANA) |
timeZoneName | 'short':短い形式 'long':長い形式 (夏時間表記あり) 'shortOffset':短い形式 (GMT 形式) 'longOffset':長い形式 (GMT 形式) 'shortGeneric':短い形式 (一般) 'longGeneric':長い形式 (一般) | タイムゾーン名 |
日付関連 | ||
dateStyle | 'full':フル形式 'long':長い形式 'medium':標準形式 'short':短い形式 | 日付スタイル |
era | 'narrow':縮小形式 'short':短い形式 'long':長い形式 | 年号 |
year | '2-digit':2桁 'numeric':ゼロサプレス | 年 |
month | '2-digit':2桁 'numeric':ゼロサプレス 'narrow':縮小形式 'short':短い形式 'long':長い形式 | 月 |
day | '2-digit':2桁 'numeric':ゼロサプレス | 日 |
weekday | 'narrow':縮小形式 'short':短い形式 'long':長い形式 | 曜日 |
時刻関連 | ||
timeStyle | 'full':フル形式 'long':長い形式 'medium':標準形式 'short':短い形式 | 時刻スタイル |
hourCycle | 'h11':12 時間形式 (0 ~ 11) 'h12':12 時間形式 (1 ~ 12) 'h23':24 時間形式 (0 ~ 23) 'h24':24 時間形式 (1 ~ 24) | 時間形式 |
hour12 | true:12 時間形式 false:24 時間形式 | 12/24 時間形式 |
dayPeriod | 'narrow':縮小形式 'short':短い形式 'long':長い形式 | 時間帯 (午前・午後 等) |
hour | '2-digit':2桁 'numeric':ゼロサプレス | 時 |
minute | '2-digit':2桁 'numeric':ゼロサプレス | 分 |
second | '2-digit':2桁 'numeric':ゼロサプレス | 秒 |
fractionalSecondDigits | undefined:なし 1~3:1桁~3桁 0:なし | 秒の小数点以下の桁数 |
例
Intl.DateTimeFormat.prototype.format【フォーマット関数】
メモ
概要
- フォーマット関数を返却
- フォーマット指定:new Intl.DateTimeFormat【コンストラクタ】
- Array.map【配列変換生成】等の利用可 (互換用)
関連
外部リンク
- ECMA-402 (英語)
get Intl.DateTimeFormat.prototype.format ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9)
構文
dateTimeFormat.format(date)
フォーマット文字列
date日時 (省略:現在日時)
例
Intl.DateTimeFormat.prototype.formatRange【範囲フォーマット】
メモ
概要
- 日時の範囲をフォーマット
- フォーマット指定:new Intl.DateTimeFormat【コンストラクタ】
関連
外部リンク
- ECMA-402 (英語)
Intl.DateTimeFormat.prototype.formatRange ( startDate, endDate ) ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9)
構文
dateTimeFormat.formatRange(startDate, endDate)
フォーマット文字列
startDate開始日時
endDate終了日時
例
Intl.DateTimeFormat.prototype.formatToParts【フォーマットパーツ取得】
Intl.DateTimeFormat.prototype.formatRangeToParts【範囲フォーマットパーツ取得】
メモ
概要
- フォーマットされた日時・日時範囲をパーツに分解
- パーツを編集し組み合わせることで、独自フォーマットが可能
関連
外部リンク
- ECMA-402 (英語)
Intl.DateTimeFormat.prototype.formatToParts ( date ) ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9) Intl.DateTimeFormat.prototype.formatRangeToParts ( startDate, endDate ) ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9)
構文
例
Intl.DateTimeFormat.prototype.resolvedOptions【オプション取得】
メモ
概要
- 以下のプロパティを持ったオプション オブジェクトを取得 (デフォルト値がない未指定のプロパティは存在しない)
(new Intl.DateTimeFormat【コンストラクタ】も参照)プロパティ 備考 locale BCP47言語タグ calendar Unicode 拡張 カレンダーフォーマット numberingSystem Unicode 拡張 数値フォーマット timeZone タイムゾーン hourCycle hour12 12/24 時間形式 weekday 曜日 era 年号 year 年 month 月 day 日 dayPeriod hour 時 minute 分 second 秒 fractionalSecondDigits timeZoneName タイムゾーン名 dateStyle timeStyle
関連
外部リンク
- ECMA-402 (英語)
Intl.DateTimeFormat.prototype.resolvedOptions () ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9)
構文
dateTimeFormat.resolvedOptions()
オプション オブジェクト
例
Intl.DateTimeFormat.supportedLocalesOf【サポート ロケール取得】
メモ
概要
- 指定したロケールから、サポート対象のロケールを取得
外部リンク
- ECMA-402 (英語)
Intl.DateTimeFormat.supportedLocalesOf ( locales [ , options ] ) ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9)
構文
Intl.DateTimeFormat.supportedLocalesOf( locales [, options])
サポートされるロケールの配列
localesBCP 47 の言語タグの文字列 または その配列
new Intl.DateTimeFormat【コンストラクタ】のlocalesを参照
optionsオプション (localeMatcher【ロケールマッチングアルゴリズム】)
new Intl.DateTimeFormat【コンストラクタ】のoptionsを参照