主要内容

このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

datenum

日付と時刻をシリアル日付値に変換

説明

メモ

シリアル日付値で日付と時刻を表すことができますが,時点を表すにはdatetime値を,経過時間を表すには持续时间値またはcalendarDuration値を使用することをお勧めします。

DateNumber= datenum (tは,入力配列tdatetime値または持续时间値をシリアル日付値に変換します。

シリアル日付値は,先発ISO暦で事前設定された固定日付(0000年1月0,)からの日数(整数および小数)を表します。

DateNumber= datenum (DateStringは,日付と時刻を表すテキストをシリアル日付値に変換します。テキストで使用されている形式が既知の場合は,形式をformatInとして指定します。formatInなしの構文は,それを含む構文に比べて大幅に遅くなります。

DateNumber= datenum (DateStringformatInformatInを使用して,DateStringで表された日付と時刻を解釈します。

DateNumber= datenum (DateStringPivotYearPivotYearを使用して,年を2文字で指定するテキストを解釈します。テキストで使用されている形式が既知の場合は,形式をformatInとして指定します。formatInなしの構文は,それを含む構文に比べて大幅に遅くなります。

DateNumber= datenum (DateStringformatInPivotYearformatInを使用してDateStringで表された日付と時刻を解釈し,PivotYearを使用して年を2文字で指定するテキストを解釈します。formatInおよびPivotYearは,いずれの順序でも指定できます。

DateNumber= datenum (DateVectorは,日付ベクトルをシリアル日付値に変換し,日付値が個の列ベクトルを返します。ここで,は,DateVectorにおける日付ベクトルの総数です。

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

さらにDateNumber= datenum (Y、M, D, H,锰、Sは,H年代(時、分、秒)配列の対応する要素のシリアル日付値を返します。配列は,同じサイズ(またはいずれかがスカラー)でなければなりません。入力引数は日付ベクトル[Y、M, D, H, MN, S]として指定することもできます。

すべて折りたたむ

格式t = [datetime (“现在”); datetime (“明天”)]
t =2 x1 datetime30-Apr-2021 22:12:28 01-May-2021 00:00:00
DateNumber = datenum (t)
DateNumber =2×1105×7.382769253306589 - 7.382770000000000
DateString =“19日——2001年5月,”;formatIn =“dd-mmm-yyyy”;datenum (DateString formatIn)
ans = 730990

datenumは,“dd-mmm-yyyy”の形式で日付を表すテキストの日付値を返します。

複数の日付を细胞配列内の文字ベクトルとして渡します。すべての入力日付に同じ形式を使用しなければなりません。

DateString = {“09/16/2007”“05/14/1996”“11/29/2010”};formatIn =“mm / dd / yyyy”;datenum (DateString formatIn)
ans =3×1733301 729159 734471

既定のピボット年を使用して,日付を表すテキストをシリアル日付値に変換します。

n = datenum (“12-jun-17”“dd-mmm-yy”
n = 736858

この日付値を表すテキストは12 - 2017年6月- - - - - -”です。

1400年ピボット年をに指定して,同じテキストをシリアル日付値に変換します。

n = datenum (“12-jun-17”“dd-mmm-yy”, 1400)
n = 517712

この日付値を表すテキストは12 - 1417年6月- - - - - -”です。

datenum([7 2 2009年,4日,11日,18))
ans = 7.3387 e + 05

年、月、日の値で指定された日付をシリアル日付値に変換します。

n = datenum(2001、12、19)
n = 731204

入力引数

すべて折りたたむ

日付と時刻。datetime値または持续时间値の配列として指定します。関数datenumではtのタイムゾーン情報を考慮せず,夏時間で発生するdatetime値の調整を行いません。つまり,datenumではdatetime配列の时区プロパティを空として扱い,日付と時刻の残りの情報に基づいてシリアル日付値への変換を行います。

データ型:datetime|持续时间

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

例:24[2003, 10日,12日,45岁的07]

データ型:

日付と時刻を表すテキスト。ある時点を表すテキストが各行に含まれる文字配列,文字ベクトルの细胞配列,または字符串ベクトルとして指定します。文字配列のすべての行,あるいは细胞ベクトルまたは字符串ベクトルのすべての要素は同じ形式でなければなりません。

例:“24 - 10月2003 12:45:07”

例:[' 19 - 9月- 2013 ',20 - 9月- 2013 ';' 21 - 9月- 2013 ']

例:{' 15 - 10月- 2010 ' 20 - 11月- 2012 '}

テキストで使用されている形式がわかっている場合は,formatInも指定しなければなりません。formatInを指定しない場合,DateStringは,次の形式のいずれかでなければなりません。

日付と時刻を表すテキストの形式

“dd-mmm-yyyy HH: MM: SS”

01 - 3月- 2000 15:45:17

“dd-mmm-yyyy”

01 - 3月- 2000

“mm / dd / yyyy”

03/01/2000

“mm / dd / yy”

03/01/00

“mm / dd”

03/01

“嗯。dd,yyyyHH:MM:SS'

2000年Mar.01 15:45:17

“mmm.dd yyyy、“

Mar.01 2000

“yyyy-mm-dd HH: MM: SS”

2000-03-01 15:45:17

“yyyy-mm-dd”

2000-03-01

“mm / dd / yyyy”

2000/03/01

“HH: MM: SS”

15:45:17

“HH: MM: SS点”

3:45:17点

“HH: MM”

15:45

“HH: MM点”

下午3:45的时候

メモ

日付と時刻の形式を示すシンボリック識別子は,datetime配列の表示形式を示すシンボリック識別子とは異なります。

一部の形式には,日付と時刻のテキスト表現を変換するために十分な情報が含まれていないことがあります。そのような場合,既定で,時,分,秒は0,日付は1月は1月,年は現在の年になります。datevecおよびdatenumは2文字の年(たとえば“79”)を現在の年を中心として100年の範囲に入るものと見なします。

formatInを指定しない場合,以下の点に注意してください。

  • 月を2桁(毫米)で指定する形式の場合,月の値が12を超えてはならない。

  • ただし,“mm / dd / yy”の形式では,テキストの1番目のエントリが12を超え,2番目のエントリが12以下の場合,datenumは,そのテキストを“yy / mm / dd”形式であると見なします。

日付と時刻を表す入力テキストの形式。シンボリック識別子の文字ベクトルまたは字符串スカラーとして指定します。

例:'dddd, MMM dd, yyyy'

次の表に,文字ベクトルformatInの作成に使用できるシンボリック識別子を示します。フィールドを区切るためのハイフン,スペース,コロンなどを含めることができます。

メモ

日付と時刻の形式を記述するシンボリック識別子は,datetime配列の表示形式を記述するシンボリック識別子とは異なります。

シンボリック識別子

説明

yyyy

4桁表記の年

19902002

yy

2桁表記の年

9002

QQ

文字と1桁で表記する四半期

第一季度

フルネームで表記する月

3月12月

最初の3文字で表記する月

3月12月

毫米

2桁表記の月

0312

大文字の頭文字で表記する月

D

dddd

フルネームで表記する曜日

周一周二

ddd

最初の3文字で表記する曜日

我的星期二

dd

2桁表記の日

0520.

d

大文字の頭文字で表記する曜日

T

HH

2桁表記の時間
(シンボリック識別子またはが使用される場合は先頭の0なし)

055

毫米

2桁表記の分

1202

党卫军

2桁表記の秒

0759

FFF

3桁表記のミリ秒

057

上午或下午

時刻を表すテキストに挿入されるまたは

3:45:02

formatIn値は次のガイドラインに従わなければなりません。

  • どのフィールドも複数回指定することはできません。たとえば,“yy-mmm-dd-m”は2つの月識別子を含むので使用できません。ただし,例外として,ddの1つのインスタンスは,他の日識別子の1つのインスタンスと組み合わせることができます。たとえば,'dddd MMM dd yyyy'は有効な入力です。

  • またはを使用する場合は,HHフィールドも必要です。

  • QQは,それだけで使用することも,年の指定子と併用することもできます。

2文字表記の年を含む100年の日付範囲の開始年を整数で指定します。ピボット年は,年が2文字で指定されている日付の解釈に使用されます。

formatInに時刻が含まれる場合,現在の年月日の現在の時刻からピボット年が計算されます。それ以外の場合は,現在の年月日の午前0時から計算されます。

例:2000

メモ

入力の日付形式で4文字の年が指定されている場合,末尾2文字は切り捨てられ,“最初”の2文字が年を指定します。たとえば,日付とピボット年が(' 25122015 ', ' ddmmyyyy ', 2000)として指定されている場合,結果の日付は25-12-2020になります。25-12-2015ではありません。

データ型:

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

Y、M, Dがすべてスカラーまたはすべて列ベクトルである場合,入力引数を日付ベクトル[Y、M, D]として指定できます。

例:2003、10、24

データ型:

年,月,日,時,分,秒の配列。数値配列として指定します。これらの配列は同じサイズでなければなりません,がいずれもスカラーにすることができます。datenumでのミリ秒は,個別の入力ではなく,秒入力年代の小数部分として認識されます。Y、M, D、H、锰の値は,整数値でなければなりません。

Y、M, D, H,锰、Sがすべてスカラーまたはすべて列ベクトルである場合,入力引数を日付ベクトル[Y、M, D, H, MN, S]として指定できます。

例:2003年,10日,24日,12日,45岁的07.451

データ型:

出力引数

すべて折りたたむ

シリアル日付値。長さの列ベクトルとして返されます。ここで,は,入力日付ベクトル,あるいは日付と時刻を表す文字ベクトルの総数です。

ヒント

  • 任意の形状の出力を作成するには,datenum (Y, M, D)およびdatenum (Y、M, D, H, MN, S)構文を使用します。datenum (DateVector)構文は,日付値の列ベクトルのみを作成します。

    datenum(2013年,[1 3;2 4], (2, 2))
    Ans = 735235 735294 735266 75325

拡張機能

R2006aより前に導入