datenum

转换日期和时间,以串行日期号

描述

例子

DateNumber= datenum (t)转换输入数组中的日期时间或持续时间值t串行日期数字。

序号表示在预期的ISO日历中从一个固定的、预先设定的日期(1月0,0000)算起的天数的整数和小数。

请注意

虽然序列号可以表示日期和时间,但建议您使用datetime表示时间点的值,和持续时间calendarDuration表示运行时间的值。

DateNumber= datenum (DateString)将表示日期和时间的文本转换为序列号。如果文本中使用的格式是已知的,则将格式指定为formatIn。语法没有formatIn比包含它的语法要慢得多。

例子

DateNumber= datenum (DateString,formatIn)使用formatIn解释为代表的日期和时间DateString

DateNumber= datenum (DateString,PivotYear)使用PivotYear要解释将年份指定为两个字符的文本。如果文本中使用的格式是已知的,则将格式指定为formatIn。语法没有formatIn比包含它的语法要慢得多。

例子

DateNumber= datenum (DateString,formatIn,PivotYear)使用formatIn解释为代表的日期和时间DateString,PivotYear要解释将年份指定为两个字符的文本。您可以指定formatInPivotYear在秩序。

例子

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 datetime2020年2月29日00:08:59 01- 3月20日00:00:00
DateNumber = datenum (t)
DateNumber =2×1105×7.378500062483986 - 7.378510000000000
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

输入参数

全部折叠

日期和时间,指定为日期时间或持续时间值的数组。的datenum函数不考虑时区信息t并且不调整夏时制期间发生的日期时间值。也就是说,datenum时区的属性datetime数组为空,并将剩余的日期和时间信息转换为串行日期号。

数据类型:datetime|持续时间

日期向量,指定为6或3矩阵包含完整或部分日期向量,分别。完整的日期向量有6个元素,按顺序指定年、月、日、小时、分钟和秒。局部日期向量有三个元素,按顺序指定年、月和日。的每个元素DateVector必须是正整数或负整数值,秒元素可以是小数。如果一个元素落在常规范围之外,datenum调整该日期向量元素和前一个元素。例如,如果minutes元素是70,然后datenum调整小时元素1并将分钟元素设置为10。如果分钟元素是-15,然后datevec将小时元素减少1并将分钟元素设置为45。月值是一个例外。的datenum函数设置的月份值小于11

例子: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分

“HH: MM点”

下午3:45的时候

请注意

描述日期和时间格式的符号标识符与描述的显示格式的符号标识符不同datetime数组。

某些格式可能没有包含足够的信息来转换日期和时间的文本表示。在这些情况下,小时、分钟和秒默认为0,天默认为1,月默认为1月,年默认为当前年。datevecdatenum以双字符年为例(例如,“79”)落在以当年为中心的100年范围内。

当你不明确的时候formatIn,请注意以下事项:

  • 有关将月份指定为两位数字的格式(毫米),月值不得大于12。

  • 但是,对于格式“mm / dd / yy”,如果文本中的第一个条目大于12,而第二个条目小于或等于12,则datenum认为文本在“yy / mm / dd”格式。

表示日期和时间的输入文本的格式,指定为符号标识符的字符向量或字符串标量。

例子:“dddd, mmm dd, yyyy”

下表显示了可用于构造formatIn特征向量。可以使用连字符、空格或冒号等字符来分隔字段。

请注意

描述日期和时间格式的符号标识符与描述的显示格式的标识符不同datetime数组。

符号标识符

描述

例子

yyyy

年全

1990,2002

yy

年的两位数字

90,02

QQ

使用信件的季度和一个数字

第一季度

使用全名的月份

3月,12月

月用前三个字母

3月,12月

毫米

两位数的月份

03,12

月的第一个字母要大写

,D

dddd

使用全名的日期

周一,周二

ddd

每天使用前三个字母

我的,星期二

dd

两位数的日

05,20.

d

第一个字母大写的日子

,T

HH

两位数小时
符号标识符时没有前导零使用)

05,5

毫米

两位数分钟

12,02

党卫军

二位数第二位

07,59

FFF

毫秒,三位数

057

上午或下午

插入表示时间的文本

3:45:02

formatIn价值观必须遵循以下准则:

  • 任何字段不能指定一次以上。例如,你不能使用“yy-mmm-dd-m”因为它有两个月的标识符。的一个例外是,您可以组合的一个实例dd使用任何其他day标识符的一个实例。例如,'dddd mmm dd yyyy'是一个有效的输入。

  • 当你使用,HH场也是必需的。

  • 您只能使用QQ单独或与年份说明。

从两个字符的年份所在的100年日期范围的年份开始,指定为整数。使用pivot年来解释将年份指定为两个字符的日期。

如果formatIn包含一天的时间,pivot年从当前的天、月和年的当前时间计算。否则,它将从当前日、月和年的午夜开始计算。

例子:2000

请注意

如果输入日期格式指定了四个字符的年份,那么最后两个字符将被截断,而第一个两个字符指定年份。例如,如果日期和pivot年指定为(' 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 735325

扩展功能

之前介绍过的R2006a