主要内容

datenum

将日期和时间转换为序列号

描述

例子

请注意

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

DateNumber= datenum (t转换datetime持续时间输入数组中的值t到序列号。

一个连续的日期数字表示从一个固定的,预先设定的日期(1月0,0000)在未来的ISO日历中的天数的整数和小数。

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

例子

DateNumber= datenum (DateStringformatIn使用formatIn解释用…表示的日期和时间DateString

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

例子

DateNumber= datenum (DateStringformatInPivotYear使用formatIn解释用…表示的日期和时间DateString,PivotYear解释将年份指定为两个字符的文本。你可以指定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 datetime26-Feb-2022 12:01:04 00:00:00
DateNumber = datenum(t)
DateNumber =2×1105× 7.385785007426090 7.385790000000000
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.3387e+05

将年、月和日值指定的日期转换为连续日期编号。

N = datenum(2001,12,19)
N = 731204

输入参数

全部折叠

的数组指定的日期和时间datetime持续时间值。的datenum函数中不考虑时区信息t并且不会调整datetime在日光节约时间期间发生的值。也就是说,datenum时区的属性datetime数组为空,并将其余日期和时间信息转换为序列号。

数据类型:datetime|持续时间

日期向量,指定为6或-by-3矩阵包含分别为完整或部分日期向量。完整的日期向量有六个元素,按此顺序指定年、月、日、小时、分钟和秒。部分日期向量有三个元素,按顺序指定年、月和日。的每个元素DateVector必须为正整数值或负整数值,seconds元素可以为小数。如果一个元素超出了常规范围,datenum调整日期向量元素和前一个元素。例如,如果minutes元素是70,然后datenum调整小时元素1并将minutes元素设置为10.如果minutes元素是-15,然后datevec减少小时元素1并将minutes元素设置为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:45

“HH: MM点”

下午3:45的时候

请注意

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

某些格式可能不包含足够的信息来转换日期和时间的文本表示形式。在这些情况下,小时、分钟和秒默认为0,天默认为1,月默认为1月,年默认为当前年份。datevec而且datenum考虑两个字符的年份(例如,“79”),以当年为中心的100年范围。

当你不指定时formatIn,请注意以下事项:

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

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

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

例子:'dddd, MMM dd, yyyy'

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

请注意

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

符号标识符

描述

例子

yyyy

全年

19902002

yy

两位数的年份

9002

QQ

季度年使用字母一个数字

第一季度

月份使用全名

3月12月

Month的前三个字母

3月12月

毫米

两位数字的月份

0312

月,首字母大写

D

dddd

使用全名的日子

周一周二

ddd

日使用前三个字母

我的星期二

dd

两位数的日子

0520.

d

使用首字母大写的日子

T

HH

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

055

毫米

两位数的分钟

1202

党卫军

两位数字中的第二位

0759

FFF

三位数的毫秒

057

上午或下午

插入表示时间的文本中

3:45:02

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

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

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

  • 你只能使用QQ单独或带有年份说明符。

以整数形式指定的包含两个字符年份的100年日期范围的开始年份。使用枢轴年解释将年份指定为两个字符的日期。

如果formatIn包含日期,枢轴年是从当前日、月和年的当前时间计算出来的。否则将从当前日、月和年的午夜开始计算。

例子:2000

请注意

如果输入日期格式指定了四个字符的年份,则最后两个字符将被截断第一个两个字符指定年份。例如,如果将日期和枢轴年指定为(' 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之前介绍