最新のリリースでは、このページがまだ翻訳されていません。このページの最新版は英語でご覧になれます。

datetime

時点を表す配列

このページをすべて展開する

説明

datetime 配列は、先発 ISO 暦を使用して時点を表します。datetime 値にはナノ秒までの精度をもつ柔軟な表示形式があり、タイムゾーン、夏時間およびうるう秒を考慮できます。

作成

構文

t = datetime

t = datetime(relativeDay)

t = datetime(DateStrings)

t = datetime(DateStrings,'InputFormat',infmt)

t = datetime(DateVectors)

t = datetime(Y,M,D)

t = datetime(Y,M,D,H,MI,S)

t = datetime(Y,M,D,H,MI,S,MS)

t = datetime(X,'ConvertFrom',dateType)

t = datetime(___,Name,Value)

説明

t = datetime は、現在の日付と時刻に対応するスカラー datetime 配列を返します。

例

t = datetime(relativeDay) は、relativeDay で指定された日付を使用します。relativeDay 入力は、'today'、'tomorrow'、'yesterday'、'now' のいずれかです。

t = datetime(DateStrings) は、時点を表す DateStrings のテキストから datetime 値の配列を作成します。

例

t = datetime(DateStrings,'InputFormat',infmt) は infmt で指定された形式を使用して、DateStrings を解釈します。DateStrings のすべての値は、同じ形式をもたなければなりません。

類似する形式のあいまいさを回避するには、'InputFormat' とそれに対応する infmt の値を指定します。

例

t = datetime(DateVectors) は、DateVectors の日付ベクトルから datetime 値の列ベクトルを作成します。

t = datetime(Y,M,D) は、Y、M、D (年、月、日) の配列の各要素に対応する datetime 値からなる配列を作成します。配列は、同じサイズ (またはいずれかがスカラー) でなければなりません。入力引数は日付ベクトル [Y M D] として指定することもできます。

t = datetime(Y,M,D,H,MI,S) は、H、MI、S (時間、分、秒) の配列も作成します。すべての配列は、同じサイズ (またはいずれかがスカラー) でなければなりません。入力引数は日付ベクトル [Y M D H MI S] として指定することもできます。

t = datetime(Y,M,D,H,MI,S,MS) は MS (ミリ秒) 配列を追加します。すべての配列は、同じサイズ (またはいずれかがスカラー) でなければなりません。

例

t = datetime(X,'ConvertFrom',dateType) は、X の数値を datetime 配列 t に変換します。dateType 引数で X の値の形式を指定します。

X に現地時刻を表す POSIX^® 時刻またはユリウス日が含まれる場合は、名前と値のペアの引数 'TimeZone' を使用して t の適切なタイムゾーンを指定します。タイムゾーンを指定しない場合、X 内の POSIX 時刻またはユリウス日は現地時刻ではなく、UTC 時刻として処理されます。

t = datetime(___,Name,Value) は、前述の構文の入力引数のいずれかに加え、1 つ以上の名前と値のペアの引数を使用して追加のオプションを指定します。たとえば、名前と値のペアの引数 'Format' を使用して t の表示形式を指定できます。

テキストから datetime 値を作成するときに最良のパフォーマンスを得るには、'Format' か、'InputFormat' とその対応する infmt の値を指定します。

入力引数

すべて展開する

`relativeDay` — 現在の日付に対する日の表現
`'yesterday'` | `'today'` | `'tomorrow'` | `'now'`

現在の日付を基準にした日。次のいずれかの値として指定します。

`relativeDay` の値	説明
`'yesterday'`	前の日の日付の午前 0 時
`'today'`	現在の日付の午前 0 時
`'tomorrow'`	次の日の日付の午前 0 時
`'now'`	現在の日付と時刻

`DateStrings` — 日付と時刻を表すテキスト
文字配列 | 文字ベクトルの cell 配列 | string 配列

日付と時刻を表すテキスト。文字配列、文字ベクトルの cell 配列または string 配列として指定します。関数 datetime は、まず DateStrings の形式を一般的な形式に一致させようとします。形式が既知の場合は、'InputFormat' とそれに対応する infmt 値を指定するか、名前と値のペアの引数 'Format' を指定します。

例: '24-Oct-2014 12:45:07'

例: {'15-Oct-2013','20-Nov-2014'}

例: ["11-Nov-2016","12-Dec-2016"]

データ型: char | cell | string

`infmt` — 入力テキストの形式
文字ベクトル | string スカラー

日付と時刻を表す入力テキストの形式。文字識別子を含む文字ベクトルまたは string スカラーとして指定します。

infmt に日付を表す指定子が含まれていない場合、datetime は DateStrings の値を現在の日付と見なします。
infmt に時刻を表す指定子が含まれていない場合、datetime は DateStrings の値を深夜 0 時と見なします。

次の表に、いくつかの一般的な入力形式と、ニューヨーク市の 2014 年 4 月 19 日 (土) 9:41:06.12345 PM の書式設定された入力の例を示します。

`infmt` の値	例
`'yyyy-MM-dd'`	`2014-04-19`
`'dd/MM/yyyy'`	`19/04/2014`
`'dd.MM.yyyy'`	`19.04.2014`
`'yyyy年 MM月 dd日'`	`2014年 04月 19日` (日本語のロケール `ja_JP` の文字)
`'MMMM d, yyyy'`	`4 月 19, 2014`
`'eeee, MMMM d, yyyy h:mm a'`	`土曜日, 4 月 19, 2014 9:41 午後`
`'MMMM d, yyyy HH:mm:ss Z'`	`4 月 19, 2014 21:41:06 -0400`
`'yyyy-MM-dd''T''HH:mmXXX'`	`2014-04-19T21:41-04:00`
`'yyyy-MM-dd HH:mm:ss.SSS'`	`2014-04-19 21:41:06.123`

秒数の小数部を表す入力テキストの場合、9 文字以下の S を使用して infmt を指定し、秒数の小数部の桁を表すことができます。たとえば、'yyyy-MM-dd HH:mm:ss.SSS' は日付と時刻をミリ秒の精度で表すテキストの形式です。

有効な文字識別子の完全な一覧については、datetime 配列の Format プロパティを参照してください。

メモ

datetime が受け入れる文字識別子は、関数 datestr、datenum および datevec で使用される識別子とは異なります。

データ型: char | string

`DateVectors` — 日付ベクトル
行列

日付ベクトルは、m 行 6 列または m 行 3 列の行列として指定され、それぞれが m の日付ベクトルの全部または一部を含みます。完全な日付ベクトルには、年、月、日、時間、分、および秒をこの順序で指定する 6 つの要素があります。部分的な日付ベクトルには、年、月、および日付をこの順序で指定する 3 つの要素があります。DateVector の各要素は、秒の要素を除き、正または負の整数値でなければなりません。秒の要素は非整数の場合もあります。ある要素が通常の範囲外である場合、datetime ではその日付ベクトル要素と直前の要素の両方が調整されます。たとえば、分の要素が 70 である場合、datetime では時間の要素の値が 1 増やされて、分の要素の値が 10 に設定されます。分の要素が -15 である場合、datetime では時間の要素の値が 1 減らされて、分の要素の値が 45 に設定されます。

例: [2014 10 24 12 45 07]

例: [2014 10 24]

`Y,M,D` — 年、月、日の配列
数値配列

年、月、日の配列。数値配列として指定します。これらの配列は同じサイズでなければなりませんが、代わりにスカラーにすることもできます。Y,M,D は整数値でなければなりません。

Y,M,D がすべてスカラーまたはすべて列ベクトルである場合、入力引数を日付ベクトル [Y M D] として指定できます。
Y、M、D のいずれかの入力の要素が通常の範囲を超える場合、datetime ではその要素と直前の入力の同じ要素の両方が調整されます。詳細は、DateVectors 入力引数の説明を参照してください。

例: 2003,10,24

`Y,M,D,H,MI,S` — 年、月、日、時、分、秒の配列
数値配列

年、月、日、時、分、秒の配列。数値配列として指定します。これらの配列は同じサイズでなければなりませんが、代わりにスカラーにすることもできます。秒の入力 S には小数を指定できます。Y,M,D,H,MI の配列は、整数値を含まなければなりません。

Y,M,D,H,MI,S がすべてスカラーまたはすべて列ベクトルである場合、入力引数を日付ベクトル [Y M D H MI S] として指定できます。
Y、M、D、H、MI、S のいずれかの入力の要素が通常の範囲を超える場合、datetime ではその要素と直前の入力の同じ要素の両方が調整されます。詳細は、DateVectors 入力引数の説明を参照してください。

例: 2003,10,24,12,45,07.451

`Y,M,D,H,MI,S,MS` — 年、月、日、時、分、秒およびミリ秒の配列
数値配列

年、月、日、時、分、秒およびミリ秒の配列。数値配列として指定します。これらの配列は同じサイズでなければなりませんが、代わりにスカラーにすることもできます。Y,M,D,H,MI,S の配列は、整数値を含まなければなりません。MS は小数のミリ秒を含むことができます。

Y、M、D、H、MI、S、MS のいずれかの入力の要素が通常の範囲を超える場合、datetime によってその要素と、直前の入力の同じ要素が両方とも調整されます。詳細は、DateVectors 入力引数の説明を参照してください。

例: 2003,10,24,12,45,07,10.52

`X` — 数値
配列

数値。配列として指定します。

`dateType` — `X` の値の形式
`'datenum'` | `'excel'` | `'excel1904'` | `'juliandate'` | ...

X の値のタイプ。次のいずれかの値として指定します。

`dateType` の値	`X` の値の形式
`'datenum'`	0000 年 1 月 0 日からの日数 (先発 ISO 暦)。
`'excel'`	1900 年 1 月 0 日からの日数。 Excel^® の日付値は、最も近いマイクロ秒に丸められます。メモ: Excel は誤って 1900 年をうるう年であると見なしています。したがって、Excel の日付値を計算するときには、1900 年 2 月 28 日と 1900 年 3 月 1 日の間に 1 日余分な日が入り、不連続性が発生します。
`'excel1904'`	1904 年 1 月 0 日からの日数。 Excel の日付値は、最も近いマイクロ秒に丸められます。メモ: Excel は誤って 1900 年をうるう年であると見なしています。したがって、Excel の日付値を計算するときには、1900 年 2 月 28 日と 1900 年 3 月 1 日の間に 1 日余分な日が入り、不連続性が発生します。
`'juliandate'`	紀元前 4714 年 11 月 24 日午後 0 時 (UTC) からの日数 (先発グレゴリオ暦)。タイムゾーンを指定せずに `X` を `datetime` 配列に変換する場合、`datetime` 値は現地時刻ではなく、UTC 時刻を表します。現地時刻を表すには、名前と値のペアの引数 `'TimeZone'` を使用してタイムゾーンを指定します。例: ニューヨークのタイムゾーンを使用して `X` を変換します。 T = datetime(X,'ConvertFrom','juliandate',... 'TimeZone','America/New_York') 次に、`TimeZone` に空の文字ベクトルを割り当てて、`T` をタイムゾーンなしで現地時刻を表す `datetime` 配列に変換できます。 T.TimeZone = ''
`'modifiedjuliandate'`	1858 年 11 月 17 日午前 0 時 (UTC) からの日数。タイムゾーンを指定せずに `X` を `datetime` 配列に変換する場合、`datetime` 値は現地時刻ではなく、UTC 時刻を表します。現地時刻を表すには、名前と値のペアの引数 `'TimeZone'` を使用してタイムゾーンを指定します。例: ニューヨークのタイムゾーンを使用して `X` を変換します。 T = datetime(X,'ConvertFrom','modifiedjuliandate',... 'TimeZone','America/New_York') 次に、`TimeZone` に空の文字ベクトルを割り当てて、`T` をタイムゾーンなしで現地時刻を表す `datetime` 配列に変換できます。 T.TimeZone = ''
`'posixtime'`	1970 年 1 月 1 日 00:00:00 (UTC) からの秒数 (うるう秒のカウントなし)。タイムゾーンを指定せずに `X` を `datetime` 配列に変換する場合、`datetime` 値は現地時刻ではなく、UTC 時刻を表します。現地時刻を表すには、名前と値のペアの引数 `'TimeZone'` を使用してタイムゾーンを指定します。例: ニューヨークのタイムゾーンを使用して `X` を変換します。 T = datetime(X,'ConvertFrom','posixtime',... 'TimeZone','America/New_York') 次に、`TimeZone` に空の文字ベクトルを割り当てて、`T` をタイムゾーンなしで現地時刻を表す `datetime` 配列に変換できます。 T.TimeZone = ''
`'yyyymmdd'`	YYYYMMDD の数値で表される日付。たとえば、`20140402` は 2014 年 4 月 2 日を表します。
`'ntp'`	1900 年 1 月 1 日 00:00:00 (UTC) からの "時間刻み" の数 (個々の時間刻みは 2^-32 秒)
`'.net'`	0001 年 1 月 1 日 00:00:00 (UTC) からの "時間刻み" の数 (個々の時間刻みは 100 ns)
`'ntfs'`	1601 年 1 月 1 日 00:00:00 (UTC) からの "時間刻み" の数 (個々の時間刻みは 100 ns)
`'epochtime','Epoch',epochValue`	特定のエポックからの秒数さらに、`epochValue` も指定しなければなりません。これは、エポック時刻を表す `datetime` スカラー、文字ベクトル、または string スカラーです。例: 2000 年 1 月 1 日からの日数が返されます。 T = datetime(X,'ConvertFrom',... 'epochtime','Epoch','2000-01-01')
`'epochtime','Epoch',epochValue,'TicksPerSecond',n`	エポック時刻からの "時間刻み" の数。 `epochValue` の指定に加えて、1 秒あたりの "時間刻み" の数であるスカラー整数 `n` を指定することもできます。例: 2000 年 1 月 1 日からの日数が返されます。`X` はこの日から前または後の時間 (ミリ秒単位) を表します。 T = datetime(X,'ConvertFrom',... 'epochtime','Epoch','2000-01-01','TicksPerSecond',1000)

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例: 'Format','eeee MMMM d, y','TimeZone','local' は、datetime 値に表示形式を適用し、ローカルタイムゾーンを指定します。

`'Format'` — 表示形式
`'default'` | `'defaultdate'` | `'preserveinput'` | 文字ベクトル | string スカラー

出力配列の値の表示形式。'Format' と次のいずれかの値で構成されるコンマ区切りのペアとして指定します。

`Format` の値	説明
`'default'`	既定の表示形式を使用します。
`'defaultdate'`	時刻の成分を含めずに作成された datetime 値用の既定の表示形式を使用します。
`'preserveinput'`	入力形式 `infmt` で指定された形式を使用します。`infmt` を指定しない場合は、`datetime` で自動的に形式が判別されます。
文字ベクトルまたは string スカラー	文字ベクトルまたは string スカラーで指定された形式を使用します。

独自の形式を指定する場合は、有効な文字識別子を使用しなければなりません。すべての有効な文字識別子の一覧については、Format プロパティを参照してください。

出荷時の既定の形式はシステムのロケールに依存します。既定の表示形式を変更するには、既定の datetime 形式を参照してください。

'InputFormat' パラメーターを指定せずに DateStrings の入力を指定した場合、datetime は Format の値に基づいて DateStrings を解釈しようとします。

例: 'Format','eeee, MMMM d, yyyy HH:mm:ss' は、日付と時刻を水曜日, 4 月 9, 2014 21:41:06 のような形式で表示します。

データ型: char | string

`'Locale'` — `DateStrings` のロケール
文字ベクトル | string スカラー

入力引数 DateStrings の値のロケール。'Locale' と、文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。Locale の値により、datetime が DateStrings を解釈する方法が決まります。ただし、出力の datetime 値を表示する方法は、これでは決まりません。

Locale の値は次のいずれかになります。

'system'。システムのロケールを使用します。
xx_YY の形式の文字ベクトルまたは string スカラー。xx は ISO 639-1 で定義された小文字 2 文字の言語コードで、YY は ISO 3166-1 alpha-2 で定義された大文字の国コードです。

次の表に一般的なロケールの値を示します。

ロケール	言語	国
`'de_DE'`	ドイツ語	ドイツ
`'en_GB'`	英語	英国
`'en_US'`	英語	米国
`'es_ES'`	スペイン語	スペイン
`'fr_FR'`	フランス語	フランス
`'it_IT'`	イタリア語	イタリア
`'ja_JP'`	日本語	日本
`'ko_KR'`	韓国語	韓国
`'nl_NL'`	オランダ語	オランダ
`'zh_CN'`	簡体字中国語	中国

名前と値のペアの引数 'Locale' は、DateStrings 入力引数を使用する場合にのみ使用できます。

例: 'Locale','de_DE'

メモ

Locale 値により、入力テキスト値の解釈方法が決まります。出力の datetime 値は常に、[設定] パネルの [日付と時刻の形式] セクションの [ロケール] オプションで指定された言語で表示されます。

datetime の表示に使用する既定のロケールを変更する方法については、コマンドウィンドウの設定を参照してください。
異なるロケールを使用して datetime 値をテキストに変換するには、関数 char、cellstr または、string を使用します。

データ型: char | string

`'PivotYear'` — 100 年の日付範囲の開始年
`year(datetime('now'))-50` (既定値) | 整数

2 文字表記の年を含む 100 年の日付範囲の開始年。'PivotYear' と整数で構成されるコンマ区切りのペアとして指定します。ピボット年は、年が 2 文字で指定されている日付の解釈に使用されます。つまり、ピボット年は infmt 引数に y または yy が含まれている場合にのみ有効になります。

名前と値のペアの引数 'PivotYear' は、DateStrings 入力引数を使用する場合にのみ使用できます。

例: 'PivotYear',1900

`'TimeZone'` — タイムゾーン
`''` (既定値) | 文字ベクトル | string スカラー

タイムゾーン。'TimeZone' と、TimeZone プロパティを指定する文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。

データ型: char | string

プロパティ

すべて展開する

`Format` — 表示形式
`'default'` | `'defaultdate'` | 文字ベクトル | string スカラー

表示形式。'default'、'defaultdate'、文字ベクトルまたは string スカラーとして指定します。

`Format` の値	説明
`'default'`	既定の表示形式を使用します。
`'defaultdate'`	時刻の成分を含めずに作成された datetime 値用の既定の表示形式を使用します。
文字ベクトルまたは string スカラー	文字ベクトルまたは string スカラーで指定された形式を使用します。

独自の形式を指定する場合は、Unicode^® ロケールデータマークアップ言語 (LDML) の標準の日付および時刻に対応する有効な文字識別子を使用しなければなりません。

例: 'eeee, MMMM d, yyyy HH:mm:ss' は、日付と時刻を水曜日, 4 月 9, 2014 21:41:06 のような形式で表示します。

フィールドを区切るために、ハイフン、スペース、コロンなどの記号や ASCII 以外の文字を含めることができます。文字 A-Z および a-z をリテラル文字として形式に含めるには、文字を一重引用符で囲みます。

例: 'uuuu-MM-dd''T''HH:mm:ss' は、日付と時刻を 2014-04-09T21:41:06 のような形式で表示します。

メモ

datetime が受け入れる文字識別子は、関数 datestr、datenum および datevec で使用される識別子とは異なります。

出荷時の既定の形式はシステムのロケールに依存します。既定の表示形式を変更するには、既定の datetime 形式を参照してください。

一般的な形式の例

次の表に一般的な表示形式を示します。ここで示す出力の例は、ニューヨーク市の 2014 年 4 月 9 日 (水) 9:41:06.12345 PM の日付に各形式を適用したものです。

`Format` の値	例
`'yyyy-MM-dd'`	`2014-04-09`
`'dd/MM/yyyy'`	`09/04/2014`
`'dd.MM.yyyy'`	`09.04.2014`
`'yyyy年 MM月 dd日'`	`2014年 04月 09日` (日本語のロケール `ja_JP` の文字)
`'MMMM d, yyyy'`	`4 月 9, 2014`
`'eeee, MMMM d, yyyy h:mm a'`	`水曜日, 4 月 9, 2014 9:41 PM`
`'MMMM d, yyyy HH:mm:ss Z'`	`4 月 9, 2014 21:41:06 -0400`
`'yyyy-MM-dd''T''HH:mmXXX'`	`2014-04-09T21:41-04:00`
`'yyyy-MM-dd HH:mm:ss.SSS'`	`2014-04-09 21:41:06.123`

すべての日付と時刻の形式

日付および時刻のフィールドの表示形式を指定するには、次の識別子を使用します。表示形式は、ニューヨーク市の 2014 年 4 月 9 日 (水) 9:41:06.12345 PM の日付の出力を示します。

文字識別子	説明	表示
`G`	紀元	`CE`
`y`	先頭に 0 を付けない表記の年。この表の後のメモを参照してください。	`2014`
`yy`	下 2 桁表記の年。この表の後のメモを参照してください。	`14`
`yyy`、`yyyy` ...	`'y'` の数に対応する桁数以上で表記した年	2014 年の場合、`'yyy'` では `2014` と表示され、`'yyyyy'` では `02014` と表示されます。
`u`、`uu` ...	ISO 年。年を単一の数値で表したものです。ISO 年では、紀元後の年が正の値、紀元前の年が負の値で表され、紀元前 1 年が 0 年になります。	`2014`
`Q`	1 桁表記の四半期	`2`
`QQ`	2 桁表記の四半期	`02`
`QQQ`	省略形で表記した四半期	`Q2`
`QQQQ`	完全名で表記した四半期	`第2四半期`
`M`	1 桁または 2 桁の数値で表記した月	`4`
`MM`	2 桁の数値で表記した月	`04`
`MMM`	短縮名で表記した月	`4月`
`MMMM`	完全名で表記した月	`4月`
`MMMMM`	大文字の頭文字で表記した月	`A`
`W`	1 桁表記の月間通算週	`2`
`d`	1 桁または 2 桁表記の月間通算日	`9`
`dd`	2 桁表記の月間通算日	`09`
`D`	1 ～ 3 桁表記の年間通算日	`99`
`DD`	2 桁表記の年間通算日	`99`
`DDD`	3 桁表記の年間通算日	`099`
`e`	1 桁または 2 桁の数値で表記した曜日	`4` (週の始まりは日曜日)
`ee`	2 桁の数値で表記した曜日	`04`
`eee`	短縮名で表記した曜日	`水`
`eeee`	完全名で表記した曜日	`水曜日`
`eeeee`	先頭文字で表記した曜日	`水`
`a`	午前と午後の区分	`午後`
`h`	1 桁または 2 桁表記の 12 時間制の時間	`9`
`hh`	2 桁表記の 12 時間制の時間	`09`
`H`	1 桁または 2 桁表記の 24 時間制の時間	`21`
`HH`	2 桁表記の 24 時間制の時間	`21`
`m`	1 桁または 2 桁表記の分	`41`
`mm`	2 桁表記の分	`41`
`s`	1 桁または 2 桁表記の秒	`6`
`ss`	2 桁表記の秒	`06`
`S`、`SS` ... `SSSSSSSSS`	`'S'` の数に対応する桁数で表記した秒の小数部 (最大 9 桁)	`'SSS'` の場合、6.12345 秒は `6.123` までに切り捨てられます。

メモ

2 桁の年番号を読み取る場合に形式を y または yy として指定すると、その年の世紀はピボット年に基づいて判別されます。
年間通算日番号を読み取る場合に年間通算日 (D) とグレゴリオ年 (y) の両方の識別子を含む形式を指定すると、datetime は年間通算日番号を正確に読み取らないことがあります。y の代わりに ISO 年 (u) を使用してください。
ゼロに近い年番号を扱うときは、文字 y の代わりに文字 u を 1 文字以上使用します。
紀元後 144683 年より後または紀元前 140743 年より前の datetime 値については、指定した Format の値に関係なく、年番号のみが表示されます。

タイムゾーンオフセットの形式

タイムゾーンオフセットの表示形式を指定するには、次の識別子を使用します。タイムゾーンオフセットは、特定の datetime と UTC との時差です。タイムゾーンには、タイムゾーンオフセットを決定するルールがあり、オフセットは 1 年のうちの時期に応じて異なります。タイムゾーンオフセットの指定子を datetime 配列の表示形式に含めると、表示する時刻の成分を明確に指定できます。

文字識別子	説明	表示
`z`	タイムゾーンオフセットの省略名。この値が指定されていない場合、タイムゾーンオフセットには `UTC-4` などの短い UTC 形式が使用されます。	`EDT`
`Z`	ISO 8601 基本形式。時、分、秒 (オプション) の各フィールドがあります。	`-0400`
`ZZZZ`	長い UTC 形式。	`UTC-04:00`
`ZZZZZ`	ISO 8601 拡張形式。時、分、秒 (オプション) の各フィールドがあります。ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。	`-04:00`
`x` または `X`	ISO 8601 基本形式。時、分 (オプション) の各フィールドがあります。`X` を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。	`-04`
`xx` または `XX`	ISO 8601 基本形式。時、分の各フィールドがあります。`XX` を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。	`-0400`
`xxx` または `XXX`	ISO 8601 拡張形式。時、分の各フィールドがあります。`XXX` を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。	`-04:00`
`xxxx` または `XXXX`	ISO 8601 基本形式。時、分、秒 (オプション) の各フィールドがあります。`XXXX` を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。	`-0400`
`xxxxx` または `XXXXX`	ISO 8601 拡張形式。時、分、秒 (オプション) の各フィールドがあります。`XXXXX` を指定すると、ISO 8601 UTC 指定子 "Z" として 0 の時間オフセットが表示されます。	`-04:00`

`TimeZone` — タイムゾーン
`''` (既定値) | 文字ベクトル | string スカラー

タイムゾーン。文字ベクトルまたは string スカラーとして指定します。TimeZone の値を指定すると、関数 datetime で入力データを解釈するときにそのタイムゾーンが使用されます。また、出力配列でも TimeZone で指定したタイムゾーンが使用されます。入力データがタイムゾーンを含む文字ベクトルまたは string である場合、関数 datetime はすべての値を指定されたタイムゾーンに変換します。

TimeZone の値は次のいずれかになります。

''。特定のタイムゾーンに属さない "ゾーンなし" の datetime 配列を作成します。
IANA タイムゾーンデータベースのタイムゾーン地域の名前 (例 'America/Los_Angeles')。タイムゾーン地域の名前では、各地域で使用される標準時および夏時間の UTC からのオフセットについて、現在および過去に実施されたルールが考慮されます。
ISO 8601 の +HH:mm または -HH:mm の形式の文字ベクトル (例 '+01:00')。UTC からの固定オフセットのタイムゾーンを指定します。
'UTC'。協定世界時に基づいて datetime 配列を作成します。
'UTCLeapSeconds'。うるう秒が考慮された協定世界時に基づいて datetime 配列を作成します。
'local'。システムのタイムゾーンに基づいて datetime 配列を作成します。TimeZone プロパティをクエリすると IANA 値が返されます。

次の表に IANA タイムゾーンデータベースの一般的なタイムゾーン地域の名前を示します。

`TimeZone` の値	UTC オフセット	UTC DST オフセット
`'Africa/Johannesburg'`	+02:00	+02:00
`'America/Chicago'`	−06:00	−05:00
`'America/Denver'`	−07:00	−06:00
`'America/Los_Angeles'`	−08:00	−07:00
`'America/New_York'`	−05:00	−04:00
`'America/Sao_Paulo'`	−03:00	−02:00
`'Asia/Hong_Kong'`	+08:00	+08:00
`'Asia/Kolkata'`	+05:30	+05:30
`'Asia/Tokyo'`	+09:00	+09:00
`'Australia/Sydney'`	+10:00	+11:00
`'Europe/London'`	+00:00	+01:00
`'Europe/Zurich'`	+01:00	+02:00

また、関数 timezones を使用して、関数 datetime が受け入れる IANA タイムゾーン名のリストを表示することもできます。

データ型: char

`Year` — 年番号
数値配列

datetime 配列の各値の年番号。サイズおよび形状が datetime 配列と同じ数値配列として指定します。それぞれの年番号は ISO カレンダーに基づく整数値です。紀元後の年の値は正、紀元前の年の値は 0 または負になります。たとえば、紀元前 1 年の年番号は 0 になります。

うるう日 (2 月 29 日) にあたる datetime 値で Year プロパティをうるう年でない年に設定すると、その日の Day と Month のプロパティが 3 月 1 日に変わります。

`Month` — 月番号
数値配列

datetime 配列の各値の月番号。サイズおよび形状が datetime 配列と同じ数値配列として指定します。それぞれの月番号は 1 から 12 までの整数値です。範囲外の値を設定した場合、Month プロパティの値が 1 から 12 までの範囲になるように Year プロパティの値が調整されます。たとえば、月番号 0 は前の年の 12 月に相当します。過去の日付の月番号は先発グレゴリオ暦に基づきます。

`Day` — 月間通算日番号
数値配列

datetime 配列の各値の月間通算日番号。サイズおよび形状が datetime 配列と同じ数値配列として指定します。月間通算日番号はそれぞれ 1 から 28、29、30 または 31 までの整数値で、値の範囲は月および年によって異なります。範囲外の値を設定した場合、Day プロパティの値が適切な範囲になるように Month プロパティと Year プロパティが調整されます。たとえば、日番号 0 は前の月の最後の日に相当します。過去の日付の日番号は先発グレゴリオ暦に基づきます。

`Hour` — 時間番号
数値配列

datetime 配列の各値の時間番号。サイズおよび形状が datetime 配列と同じ数値配列として指定します。それぞれの時間番号は 0 から 23 までの整数値です。範囲外の値を設定した場合、Hour プロパティの値が適切な範囲になるように Day、Month、Year のプロパティが調整されます。たとえば、時間番号 -1 は前の日の 23 時に相当します。

夏時間に従う特定のタイムゾーンの datetime 配列には、以下の条件が適用されます。

夏時間開始時の時間の隙間によって生じる存在しない datetime を作成する値を Hour プロパティに指定した場合は、Hour プロパティが 1 時間後の時刻に調整されます。
夏時間終了時の時間のオーバーラップによって生じるあいまいな datetime を作成する値を Hour プロパティに指定した場合は、2 つの時刻のうち標準時で 2 番目にあたる時刻に datetime が調整されます。

`Minute` — 分番号
数値配列

datetime 配列の各値の分番号。サイズおよび形状が datetime 配列と同じ数値配列として指定します。それぞれの分番号は 0 から 59 までの整数値です。範囲外の値を指定した場合、Minute プロパティの値が適切な範囲になるように Hour、Day、Month、Year のプロパティが調整されます。たとえば、分番号 -1 は前の時刻の 59 分に対応します。

`Second` — 秒数
数値配列

datetime 配列の各値の秒数。サイズおよび形状が datetime 配列と同じ数値配列として指定します。それぞれの秒の値は浮動小数点値で、通常は 0 以上 60 未満の範囲になります。範囲外の値を設定した場合、Second プロパティの値が適切な範囲になるように Minute、Hour、Day、Month、Year のプロパティが調整されます。たとえば、-1 秒は前の分の 59 秒に対応します。

TimeZone の値が 'UTCLeapSeconds' に設定された datetime 配列の場合、秒の範囲は 0 以上 61 未満になります。60 ～ 61 の値はうるう秒の datetime を表します。

`SystemTimeZone` — システムのタイムゾーン設定
文字ベクトル | string スカラー

このプロパティは読み取り専用です。

システムのタイムゾーン設定。文字ベクトルまたは string スカラーとして指定します。このタイムゾーン設定は MATLAB^® を実行しているシステムによって決まります。

例: America/New_York

例

すべて折りたたむ

特定のタイムゾーンの現在の日付と時刻

ライブスクリプトを開く

ローカルシステムのタイムゾーンにおける現在の日付と時刻を指定します。

t = datetime('now','TimeZone','local','Format','d-MMM-y HH:mm:ss Z')

t = datetime
   2-Aug-2018 18:16:52 -0400

韓国のソウルのタイムゾーンにおける現在の日付と時刻を指定します。

t = datetime('now','TimeZone','Asia/Seoul','Format','d-MMM-y HH:mm:ss Z')

t = datetime
   3-Aug-2018 07:16:52 +0900

文字ベクトルの日付と時刻

ライブスクリプトを開く

文字ベクトルの cell 配列から datetime 配列を作成します。

DateStrings = {'2014-05-26';'2014-08-03'};
t = datetime(DateStrings,'InputFormat','yyyy-MM-dd')

t = 2x1 datetime array
   26-May-2014
   03-Aug-2014

t の datetime 値は、入力日付の形式ではなく既定の形式で表示されます。

string 配列の日付と時刻

ライブスクリプトを開く

R2016b 以降では、関数 string を使用して string 配列を作成し、その後 datetime 値に変換することができます。

str = string({'2016-03-24','2016-04-19'})

str = 1x2 string array
    "2016-03-24"    "2016-04-19"

入力形式を yyyy-MM-dd に指定して、string を変換します。str が string 配列であっても、形式は文字ベクトルとして指定しなければなりません。

t = datetime(str,'InputFormat','yyyy-MM-dd')

t = 1x2 datetime array
   24-Mar-2016   19-Apr-2016

秒数の小数部を表すテキストからの時刻

ライブスクリプトを開く

日付と時刻をミリ秒の精度で表すテキストから datetime 値を作成します。関数 datetime での解析に必要な詳細情報のない形式のテキストを変換するために、'InputFormat' の名前と値のペアの引数を指定します。

d = '2018-06-25 11:23:37.712';
t = datetime(d,'InputFormat','yyyy-MM-dd HH:mm:ss.SSS')

t = datetime
   25-Jun-2018 11:23:37

この変換では秒数の小数部が保持されます。しかし、既定の datetime 配列は秒数の小数部を "表示" しません。これを表示するには、'Format' の名前と値のペア、または Format プロパティのいずれかを指定します。

t.Format = 'MMM dd, yyyy HH:mm:ss.SSS'

t = datetime
   Jun 25, 2018 11:23:37.712

'InputFormat' 引数は、入力テキストからの変換にのみ適用されます。Format プロパティは、すべての datetime 配列の表示を指定します。

リテラル文字のテキストの日付と時刻

ライブスクリプトを開く

ISO 8601 形式の日付を datetime 値に変換します。

ISO 8601 形式の日付を含む文字ベクトルからなる cell 配列を作成します。この形式では、日付と時刻の区切り記号として文字 T が使用されます。各文字ベクトルにタイムゾーンオフセットが含まれます。文字 Z は UTC からのオフセットがゼロであることを示します。

DateStrings = {'2014-05-26T13:30-05:00';'2014-08-26T13:30-04:00';'2014-09-26T13:30Z'}

DateStrings = 3x1 cell array
    {'2014-05-26T13:30-05:00'}
    {'2014-08-26T13:30-04:00'}
    {'2014-09-26T13:30Z'     }

文字ベクトルを datetime 値に変換します。入力形式を指定するときに、文字 T を一重引用符で囲んでリテラル文字であることを示します。名前と値のペアの引数 TimeZone を使用して、出力する datetime 配列のタイムゾーンを指定します。

t = datetime(DateStrings,'InputFormat','uuuu-MM-dd''T''HH:mmXXX','TimeZone','UTC')

t = 3x1 datetime array
   26-May-2014 18:30:00
   26-Aug-2014 17:30:00
   26-Sep-2014 13:30:00

t の datetime 値は、既定の形式で表示されます。

外国語表記のテキストの日付と時刻

ライブスクリプトを開く

フランス語の日付を含む文字ベクトルの cell 配列を作成します。

C = {'8 avril 2013','9 mai 2013';'10 juin 2014','11 juillet 2014'}

C = 2x2 cell array
    {'8 avril 2013'}    {'9 mai 2013'     }
    {'10 juin 2014'}    {'11 juillet 2014'}

C の文字ベクトルを datetime 値に変換します。使用しているコンピューターが英語を使用するロケールに設定されている場合、名前と値のペアの引数 'Locale' を使用して、その string がフランス語表記であることを示さなければなりません。

t = datetime(C,'InputFormat','d MMMM yyyy','Locale','fr_FR')

t = 2x2 datetime array
   08-Apr-2013   09-May-2013
   10-Jun-2014   11-Jul-2014

t の datetime 値は、既定の形式、および設定されているシステムロケールに基づいて MATLAB が使用する言語で表示されます。

ベクトルの日付と時刻

ライブスクリプトを開く

年、月、日の値が別々に格納された複数の配列から datetime 配列を作成します。

年の値 Y と日の値 D のサンプル数値配列を作成します。この例では、月の値 M はスカラーにします。

Y = [2014;2013;2012];
M = 01;
D = [31;30;31];

datetime 配列を作成します。

t = datetime(Y,M,D)

t = 3x1 datetime array
   31-Jan-2014
   30-Jan-2013
   31-Jan-2012

名前と値のペアの引数 Format を使用して出力のカスタム表示形式を指定します。

t = datetime(Y,M,D,'Format','eeee, MMMM d, y')

t = 3x1 datetime array
   Friday, January 31, 2014   
   Wednesday, January 30, 2013
   Tuesday, January 31, 2012

Excel 日付値の datetime への変換

ライブスクリプトを開く

1900 年 1 月 0 日からの日数を表す Excel® 日付値のサンプル配列を作成します。

X = [39558, 39600; 39700, 39800]

X = 2×2

       39558       39600
       39700       39800

X の値を datetime 値に変換します。

t = datetime(X,'ConvertFrom','excel')

t = 2x2 datetime array
   20-Apr-2008 00:00:00   01-Jun-2008 00:00:00
   09-Sep-2008 00:00:00   18-Dec-2008 00:00:00

ヒント

関数 datetime の一覧については、日付と時刻を参照してください。
datetime 配列を入力引数として受け入れる MATLAB の主要な関数の一覧については、日付と時刻の配列をサポートする主要な関数を参照してください。

拡張機能

tall 配列
メモリの許容量を超えるような多数の行を含む配列を計算します。

使用上の注意事項および制限事項:

cell 配列内の string 配列または文字ベクトルに tall datetime 配列を作成するときは、入力に datetime 形式を必ず指定します。
'Format' を 'preserveinput' として指定した場合、MATLAB は形式を判別するために tall 配列を評価しなければならない場合があります。

詳細については、tall 配列を参照してください。

分散配列
Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

使用上の注意事項および制限事項:

DateStrings のテキストから datetime 配列を作成するときには、入力形式 infmt を指定します。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

参考

datetime

説明

作成

構文

説明

入力引数

relativeDay — 現在の日付に対する日の表現 'yesterday' | 'today' | 'tomorrow' | 'now'

DateStrings — 日付と時刻を表すテキスト 文字配列 | 文字ベクトルの cell 配列 | string 配列

infmt — 入力テキストの形式 文字ベクトル | string スカラー

メモ

DateVectors — 日付ベクトル 行列

Y,M,D — 年、月、日の配列 数値配列

Y,M,D,H,MI,S — 年、月、日、時、分、秒の配列 数値配列

Y,M,D,H,MI,S,MS — 年、月、日、時、分、秒およびミリ秒の配列 数値配列

X — 数値 配列

dateType — X の値の形式 'datenum' | 'excel' | 'excel1904' | 'juliandate' | ...

名前と値のペアの引数

'Format' — 表示形式 'default' | 'defaultdate' | 'preserveinput' | 文字ベクトル | string スカラー

'Locale' — DateStrings のロケール 文字ベクトル | string スカラー

メモ

'PivotYear' — 100 年の日付範囲の開始年 year(datetime('now'))-50 (既定値) | 整数

'TimeZone' — タイム ゾーン '' (既定値) | 文字ベクトル | string スカラー

プロパティ

Format — 表示形式 'default' | 'defaultdate' | 文字ベクトル | string スカラー

メモ

一般的な形式の例

すべての日付と時刻の形式

メモ

タイム ゾーン オフセットの形式

TimeZone — タイム ゾーン '' (既定値) | 文字ベクトル | string スカラー

Year — 年番号 数値配列

Month — 月番号 数値配列

Day — 月間通算日番号 数値配列

Hour — 時間番号 数値配列

Minute — 分番号 数値配列

Second — 秒数 数値配列

SystemTimeZone — システムのタイム ゾーン設定 文字ベクトル | string スカラー

例

特定のタイム ゾーンの現在の日付と時刻

文字ベクトルの日付と時刻

string 配列の日付と時刻

秒数の小数部を表すテキストからの時刻

リテラル文字のテキストの日付と時刻

外国語表記のテキストの日付と時刻

ベクトルの日付と時刻

Excel 日付値の datetime への変換

ヒント

拡張機能

tall 配列 メモリの許容量を超えるような多数の行を含む配列を計算します。

分散配列 Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

参考

トピック

R2014b で導入

Select a Web Site

How to Get Best Site Performance

Americas

Europe

Asia Pacific

MATLAB ドキュメンテーション

サポート

MATLABで始めるディープラーニング

`relativeDay` — 現在の日付に対する日の表現
`'yesterday'` | `'today'` | `'tomorrow'` | `'now'`

`DateStrings` — 日付と時刻を表すテキスト
文字配列 | 文字ベクトルの cell 配列 | string 配列

`infmt` — 入力テキストの形式
文字ベクトル | string スカラー

`DateVectors` — 日付ベクトル
行列

`Y,M,D` — 年、月、日の配列
数値配列

`Y,M,D,H,MI,S` — 年、月、日、時、分、秒の配列
数値配列

`Y,M,D,H,MI,S,MS` — 年、月、日、時、分、秒およびミリ秒の配列
数値配列

`X` — 数値
配列

`dateType` — `X` の値の形式
`'datenum'` | `'excel'` | `'excel1904'` | `'juliandate'` | ...

`'Format'` — 表示形式
`'default'` | `'defaultdate'` | `'preserveinput'` | 文字ベクトル | string スカラー

`'Locale'` — `DateStrings` のロケール
文字ベクトル | string スカラー

`'PivotYear'` — 100 年の日付範囲の開始年
`year(datetime('now'))-50` (既定値) | 整数

`'TimeZone'` — タイムゾーン
`''` (既定値) | 文字ベクトル | string スカラー

`Format` — 表示形式
`'default'` | `'defaultdate'` | 文字ベクトル | string スカラー

タイムゾーンオフセットの形式

`TimeZone` — タイムゾーン
`''` (既定値) | 文字ベクトル | string スカラー

`Year` — 年番号
数値配列

`Month` — 月番号
数値配列

`Day` — 月間通算日番号
数値配列

`Hour` — 時間番号
数値配列

`Minute` — 分番号
数値配列

`Second` — 秒数
数値配列

`SystemTimeZone` — システムのタイムゾーン設定
文字ベクトル | string スカラー

特定のタイムゾーンの現在の日付と時刻

tall 配列
メモリの許容量を超えるような多数の行を含む配列を計算します。

分散配列
Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。