DateString

DateString[]

给出一个表示完整的当前本地日期和时间的字符串.

DateString[date]

给出与指定 date 对应的字符串.

DateString[{"elem1","elem2",…}]

按照给定的顺序连接指定的元素.

DateString[date,fmt]

给出日期或时间指定 date 的由日期格式 fmt 规定的元素.

更多信息和选项

  • DateString 通常用于按照国际标准和惯例在报告和表格中生成人类可读的日期或机器可读的日期.
  • 在 DateString[date] 中，可用以下日期和时间规范给出 date：
  • dateDateObject 规范
    {y,m,d,h,m,s}DateList 规范
    timeAbsoluteTime 规范
    "string"DateString 规范
    {"string",fmt}根据指定格式形成的日期字符串
  • 日期字符串由一系列日期元素组成，如 "Year"、"Month"、"Day" 等. 常见的元素集合被赋予特殊的名称，如 "DateTimeShort" 或 "ISOWeekDate"，可将其用作日期字符串的元素.
  • DateString[elem] 等价于 DateString[{elem}].
  • 在 DateString[date,fmt] 中，格式规范 fmt 通常包括：
  • Automatic自动确定日期格式
    "format"已命名日期格式（如 "ISODateTime"）
    {elem1,elem2,…}有序元素（如： "Year", "Day", …）
    assoc日期格式参数 Association
    locale地区指定（如 "en_US"）
  • locale 使用给定地区指定的默认日期格式信息，包括元素的顺序、语言、书写脚本和分隔符. 可用地区设定字符串给出地区设置，如 "en_US"、"LanguageLocale" 实体或 "Language" 实体.
  • 可在 assoc 指定中给出以下参数：
  • "Elements"Automatic要包括的日期字符串元素
    "Language"$Language文字元素使用的语种
    "WritingScript"Automatic文字元素的书写脚本
    "Delimiters"Automatic日期元素之间的分隔符
  • 可用语言字符串（如 "Spanish"）、ISO-639 语言代码（如 "es"）、"Language" 实体或 "LanguageLocale" 实体给出 "Language"lang.
  • 可用书写脚本字符串（如 "Latin"）、ISO-15924 书写脚本代码（如 "Latn"）或 "WritingScript" 实体给出 "WritingScript"script.
  • 对于 <|"Delimiters"delims|>，分隔符将按照 Riffle 的行为插入元素列表中.
  • 已命名格式规范包括：
  • "Date"完整日期Wednesday 26 July 2023
    "DateShort"简短形式的日期Wed 26 Jul 2023
    "Time"完整时间11:02:11
    "DateTime"完整日期和时间Wednesday 26 July 2023 11:02:11
    "DateTimeShort"简短形式的日期和时间Wed 26 Jul 2023 11:02:11
    "ISODate"ISO-8601 日期2023-07-26
    "ISOWeekDate"ISO 周日期2023-W30-3
    "ISOOrdinalDate"ISO 序数日期2023-207
    "ISODateTime"ISO 日期和时间2023-07-26T11:02:11
    "ISODateTimeMillisecond"ISO 日期和精确到毫秒的时间2023-07-26T11:02:11.123
  • 包含基于地区设定的格式的已命名格式有：
  • "LocaleDateCompact"只使用数字元素的日期（如 7/26/23）
    "LocaleDateShort"使用缩写格式的日/月的日期（如 Jul 26, 2023）
    "LocaleDateLong"使用完整格式的日/月的日期（如 July 26, 2023）
    "LocaleDateFull"含有星期几的日期（如 Wednesday, July 26, 2023）
    "LocaleTimeCompact"不含秒的时间（如 11:02 AM）
    "LocaleTimeShort"含秒的时间（如 11:02:11 AM）
    "LocaleTimeLong"含有时区缩写的时间（如 11:02:11 AM CST）
    "LocaleTimeFull"含有完整时区名称的时间（如 11:02:11 AM Central Standard Time）
    "LocaleDateTimeCompact"含有时间的格式紧凑的日期（如 7/26/23,11:02:11 AM）
    "LocaleDateTimeShort"含有时间的月份使用缩写的日期（如 Jul 26, 2023, 11:02:11 AM）
    "LocaleDateTimeLong"含有时间的完整格式的日期（如 July 26, 2023 at 11:02:11 AM）
    "LocaleDateTimeFull"完整的日期和时间（如 Wednesday, July 26, 2023 at 11:02:11 AM）
  • 其中具体包含的元素及其顺序由与这些已命名格式一起使用的区域设置决定.
  • 与年份相关的元素包括：
  • "Year"完整年份2005
    "YearShort"两位数的年份05
    "YearExact"包含小数的年份2005.26
    "YearFraction"部分年份0.256625
    "ISOYear"ISO-8601 格式的年份2005
    "YearSigned"包括-负数年份-2005
    "YearUnsigned"无符号的年份2005
    "YearADBC"包括后缀，三位数年份940 AD
    "YearCEBCE"包括后缀，三位数年份940 CE
    "YearRomanNumeral"用罗马数字表示的年份MMV
    "ADBC"AD 或 BCAD
    "CEBCE"CE 或 BCEBCE
  • 与月份相关的元素包括：
  • "Month"两位数的月份08
    "MonthShort"用 1 位数或 2 位数表示的月份8
    "MonthExact"包含小数的月份8.26759
    "MonthFraction"月份的小数部分0.267586
    "MonthName"月份名称August
    "MonthNameShort"月份名称的简称Aug
    "MonthNameInitial"月份名的首字母A
    "MonthRomanNumeral"用罗马数字表示的月份VIII
    "MonthRomanNumeralLowerCase"用小写罗马数字表示的月份viii
  • 与月的某一天相关的元素包括：
  • "Day"用两位数表示月的某一天09
    "DayShort"用 1 位数或 2 位数表示月的某一天9
    "DayExact"包含小数的天9.29518
    "DayFraction"天的小数部分0.295176
  • 与星期几相关的元素包括：
  • "DayName"星期几Wednesday
    "DayNameShort"星期几的缩写Wed
    "DayNameInitial"星期几的首字母W
    "ISOWeekDay"ISO-8601 表示法，一周的第几天4
    "ISOWeekDayExact"包含小数的一周的第几天4.29518
    "ISOWeekDayFraction"部分天数0.295176
  • 与小时相关的元素包括：
  • "Hour"
  • 2位数的小时
    		• 19
    "Hour12"2 位数，12 小时时钟系统07
    "Hour24"2 位数，24 小时时钟系统19
    "HourShort"1 位数或 2 位数的小时19
    "Hour12Short"1 位数或 2 位数，12 小时时钟系统7
    "Hour24Short"1 位数或 2 位数，24 小时时钟系统19
    "HourExact"包含小数的小时7.08422
    "HourFraction"小时的小数部分0.0842222
    "AMPM"AM 或 PMPM
    "AMPMLowerCase"am 或 pmpm
  • 与分钟相关的元素包括：
  • "Minute"用 2 位数表示的分钟05
    "MinuteShort"用 1 位数或 2 位数表示的分钟5
    "MinuteExact"包含小数的分钟5.05333
    "MinuteFraction"分钟的小数部分0.0533333
  • 与秒相关的元素包括：
  • "Second"用 2 位数表示的秒03
    "SecondShort"用 1 位数或 2 位数表示的秒3
    "SecondExact"包含小数的秒03.199
    "SecondFraction"秒的小数部分0.2
    "Millisecond"用 3 位数表示的毫秒019
    "MillisecondShort"用 1 位数、2 位数或 3 位数表示的毫秒19
    "MillisecondExact"包含小数的毫秒019.99
    "MillisecondFraction"毫秒的小数部分0.999809
  • 比一年大的元素包括：
  • "Millennium"从年 X000 开始-3000
    "MillenniumUnsigned"无符号千年3000
    "MillenniumBeginning01"从年 X001 开始2001
    "Century"从年 XX00 开始-2100
    "CenturyUnsigned"无符号世纪2100
    "CenturyBeginning01"从年 XX01 开始2001
    "Decade"10 年周期-2010
    "DecadeUnsigned"无符号十年2010
  • 与多个日期元素相关的元素包括：
  • "Quarter"季度数1
    "QuarterName"年的季度Quarter 1
    "QuarterNameShort"简短形式的年的季度Q1
    "Week"用 2 位数表示的周数02
    "WeekShort"用 1 位数或 2 位数表示的周数2
    "WeekExact"包含小数的周数2.44048
    "WeekFraction"部分周数0.440478
  • 其他 ISO-8601 日期元素包括：
  • "ISOYearDay"用 3 位数表示的年的天数094
    "ISOYearDayShort"用 1 位数、2 位数或 3 位数表示的年的天数94
    "ISOYearDayExact"包含小数的年的天数94.295
    "ISOYearDayFraction"部分年的天数0.295176
  • 与时区相关的元素包括：
  • "TimeZoneGMTRelative"GMT 偏移GMT-04:00
    "ISOTimeZone"ISO-8601 GMT 偏移-04:00
    "TimeZoneName"时区名称Eastern Standard Time
    "TimeZoneNameShort"时区名简称EST
  • 元素列表中的任何其它字符串都是按字面在输出字符串中进行连接.
  • 默认情况下，DateString[] 给出 $DateStringFormat 指定的形式的输出.
  • 在云端，$DateStringFormat 将根据 $GeoLocationCountry 提供的地区信息进行设置.
  • 如果 $DateStringFormat 被设为常见值，DateString[{y,m,d,h,m,s}] 将对分数秒数进行四舍五入..
  • 可在 DateString[{y,m,…}] 中使用较短的列表：{y} 相当于 {y,1,1,0,0,0}，{y,m} 相当于 {y,m,1,0,0,0} 等.
  • 将超出正常范围的 m、d、h、m、s 值适当化简. d、h、m、s 也可以取非整数值. »
  • 在 DateString[{"string",{"e1","e2",…},…] 形式中，"ei" 可以是 "Year"、"YearShort"、"Quarter"、"Month"、"MonthName"、"Day"、"DayName"、"Hour"、"Hour12"、"AMPM"、"Minute" 或 "Second".
  • DateString[{"string",{"e1","e2",…},…] 用 "ei" 填充 {y,m,d,h,m,s} 的元素. 那些没有填充的元素采用缺省值 {yc,1,1,0,0,0}，其中 yc 是当前年份. »
  • 在 DateString[{"string",{"e1","e2",…},…] 中，从 "string" 中按照给定顺序提取 "ei"，并且可以被任何非字母或数字的符号分隔开. »
  • DateString[{"string",{"e1","sep12","e2","sep23",…},…] 根据给定的分隔符提取元素. »
  • 对于 "*Exact" 元素（例如，"SecondExact" 和 "MonthExact"），返回值的整数部分会匹配正常元素（例如，"Second" 和 "Month"）给定的值.
  • DateString[date] 使用指定 DateObject 的 DateFormat 值确定包括在结果字符串中的元素.
  • 在 DateString[spec,elems] 中，对应于 spec 的时间和日期在默认情况下被假定是在由 $TimeZone 确定的时区内，除非 spec 显式地确定另外的时区.
  • DateString[spec,elems,TimeZone->z] 给出转换到时区 z 的输出.
  • DateString[] 使用任何已在用户计算机系统中设置的日期和时间. 它不执行对时区、夏令时等的校正.
  • DateString[TimeZone -> z] 假定用户计算机被设置于由 $TimeZone 确定的时区，从而给出由时区 z 推断的日期和时间. »

范例

打开所有单元关闭所有单元

基本范例  (5)

求当前日期：

以指定格式给出当前日期：

以指定格式给出日期：

DateString 支持大量 ISO-8601 日期格式：

获取当前日期的日语表示：

范围  (13)

计算所给日期是星期几：

将日期列表转换为标准形式：

可能情况下，自动解释字符串：

DateObject 和 TimeObject 表达式均包括默认的 DateFormat 值：

如果没有特别指定，自动认定输入字符串的分隔符：

为输入日期的字符串指定明确的分隔符：

天、小时、分钟和秒值可以是非整数：

如果字符串中没有给出年份，则采用当前的年份：

将绝对时间转换成日期字符串：

获取日期字符串的法语表示：

根据系统语言区域生成日期字符串：

指定语言和地区格式：

同时指定要包含哪些要素以及使用何种语言：

选项  (1)

TimeZone  (1)

给出英国格林尼治的当前日期：

利用时区字符串，为指定日期获取日期字符串：

应用  (1)

制作一个动态更新的时钟：

属性和关系  (6)

DateObject 表示给定日期：

AbsoluteTime 用自 1900 年开始以来的秒数表示日期：

DateList 将日期表示为日期元素列表的形式：

DateString 用字符串表示日期：

用 $DateStringFormat 定义输出格式：

DateString 给出匹配 DatePattern 的结果：

在日期字符 坐标中，用 DateListPlot 绘制数据：

用 DatePlus 给一个日期字符串增加时间单位：

用 DateDifference，求出日期间的时间的单位数：

用 Order 和 DateList 确定日期的顺序：

可能存在的问题  (3)

需要明确的元素，用于解释有歧义的字符串：

对于数值的 TimeZone 值，会以 GMT 差量的形式返回元素 "TimeZoneName" 和 "TimeZoneNameShort"：

当使用已命名的 TimeZone，会返回合适的 "TimeZoneName"：

元素 "WeekExact" 使用 "Week" 同样的整数部分，因此永远不会返回小于 1 的值：

所有零索引元素都是如此：

Wolfram Research (2007)，DateString，Wolfram 语言函数，https://reference.wolfram.com/language/ref/DateString.html （更新于 2024 年）.

文本

Wolfram Research (2007)，DateString，Wolfram 语言函数，https://reference.wolfram.com/language/ref/DateString.html （更新于 2024 年）.

CMS

Wolfram 语言. 2007. "DateString." Wolfram 语言与系统参考资料中心. Wolfram Research. 最新版本 2024. https://reference.wolfram.com/language/ref/DateString.html.

APA

Wolfram 语言. (2007). DateString. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/DateString.html 年

BibTeX

@misc{reference.wolfram_2024_datestring, author="Wolfram Research", title="{DateString}", year="2024", howpublished="\url{https://reference.wolfram.com/language/ref/DateString.html}", note=[Accessed: 17-November-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_datestring, organization={Wolfram Research}, title={DateString}, year={2024}, url={https://reference.wolfram.com/language/ref/DateString.html}, note=[Accessed: 17-November-2024 ]}