FromDateString

FromDateString["string"]

给出与 "string" 表示的日期对应的日期对象.

FromDateString["string",{"e1","e2",…}]

给出通过从 "string" 提取元素 "ei" 获得的日期对象.

FromDateString["string",fmt]

给出用日期格式 fmt 获得的日期对象.

更多信息和选项

  • FromDateString 将任何表示日期的字符串解析为 Wolfram 语言中标准的 DateObject 形式，同时考虑区域设置和时区信息.
  • FromDateString 接受任意日期字符串数组.
  • 在 FromDateString["string",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"完整日期Thursday 4 April 2019
    "DateShort"简短形式的日期Thu 4 Apr 2019
    "Time"完整时间15:57:49
    "DateTime"完整日期和时间Thursday 4 April 2019 15:57:57
    "DateTimeShort"简短形式的日期和时间Thu 4 Apr 2019 15:58:08
    "ISODate"ISO-8601 日期2019-04-04
    "ISOWeekDate"ISO 周日期2019-W14-4
    "ISOOrdinalDate"ISO 序数日期2019-094
    "ISODateTime"ISO 日期和时间2019-04-04T15:58:57
  • 包含基于地区设定的格式的已命名格式有：
  • "LocaleDateCompact"只使用数字元素的日期（如 1/12/21）
    "LocaleDateShort"使用缩写格式的日/月的日期（如 Jan. 12, 2021）
    "LocaleDateLong"使用完整格式的日/月的日期（如 January 12, 2021）
    "LocaleDateFull"含有星期几的日期（如 Tuesday, January 12, 2021）
    "LocaleTimeCompact"不含秒的时间（如 2:07 PM）
    "LocaleTimeShort"含秒的时间（如 2:07:23 PM）
    "LocaleTimeLong"含有时区缩写的时间（如 2:07:23 PM CST）
    "LocaleTimeFull"含有完整时区名称的时间（如 2:07:23 PM Central Standard Time）
    "LocaleDateTimeCompact"含有时间的格式紧凑的日期（如 1/12/21, 2:07:23 PM）
    "LocaleDateTimeShort"含有时间的月份使用缩写的日期（如 Jan 12, 2021, 2:07:23 PM）
    "LocaleDateTimeLong"含有时间的完整格式的日期（如 January 12, 2021 at 2:07:23 PM）
    "LocaleDateTimeFull"完整的日期和时间（如 Tuesday, January 12, 2021 at 2:07:23 PM）
  • 其中具体包含的元素及其顺序由与这些已命名格式一起使用的区域设置决定.
  • 与年份相关的元素包括：
  • "Year"完整年份2005
    "YearShort"两位数的年份05
    "ISOYear"ISO-8601 格式的年份2005
    "YearUnsigned"没有符号的年份2005
    "ADBC"AD 或 BCAD
    "CEBCE"CE 或 BCEBCE
  • 与月份相关的元素包括：
  • "Month"两位数的月份08
    "MonthShort"用 1 位数或 2 位数表示的月份8
    "MonthName"月份的名称August
    "MonthNameShort"简短形式的月份名称Aug
    "MonthNameInitial"月份名称的首字母A
  • 与月的某一天相关的元素包括：
  • "Day"用两位数表示月的某一天09
    "DayShort"用 1 位数或 2 位数表示月的某一天9
  • 与星期几相关的元素包括：
  • "DayName"星期几Wednesday
    "DayNameShort"星期几的缩写Wed
    "DayNameInitial"星期几的首字母W
    "ISOWeekDay"ISO-8601 表示法，一周的第几天4
  • 与小时相关的元素包括：
  • "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
    "AMPM"AM 或 PMPM
    "AMPMLowerCase"am 或 pmpm
  • 与分钟相关的元素包括：
  • "Minute"用 2 位数表示的分钟05
    "MinuteShort"用 1 位数或 2 位数表示的分钟5
  • 与秒相关的元素包括：
  • "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
  • 与多个日期元素相关的元素包括：
  • "Quarter"季度数1
    "QuarterName"年的季度Quarter 1
    "QuarterNameShort"简短形式的年的季度Q1
    "Week"用 2 位数表示的周数02
    "WeekShort"用 1 位数或 2 位数表示的周数2
  • 其他 ISO-8601 日期元素包括：
  • "ISOYearDay"用 3 位数表示的年的天数094
    "ISOYearDayShort"用 1 位数、2 位数或 3 位数表示的年的天数94
  • 与时区相关的元素包括：
  • "TimeZoneGMTRelative"GMT 偏移GMT-04:00
    "ISOTimeZone"ISO-8601 GMT 偏移-04:00
    "TimeZoneName"时区名称Eastern Standard Time
    "TimeZoneNameShort"时区名简称EST
  • 元素列表中的任何其它字符串都是按字面出现在日期字符串中.
  • 可能的选项包括：
  • CalendarType Automatic输出的日历系统
    DateFormat Automatic用来显示日期的格式
    DateGranularity Automatic输出日历粒度
    TimeSystemAutomatic使用的时间系统
    TimeZone Automatic输出的时区
  • 可能的 CalendarType 规范包括 Automatic、"Gregorian"、"Julian" 以及 CalendarData["DateCalendar"] 中的其他日历.
  • TimeZone 规范应该是离 GMT 的数字偏移量、时区字符串或实体、None 或地理实体位置.
  • 可用 DateFormat 来指定由 FromDateString 返回的 DateObject 的输出格式.
  • "string" 输入始终被假定为 "Gregorian" 日历系统.

范例

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

基本范例  (4)

从日期字符串输入中获取日期对象：

用指定日期格式解析日期字符串：

日期格式规范可以包括元素、语言、书写脚本和分隔符：

可用日期格式指定区域设置，它提供元素及其顺序，以及语言和脚本：

范围  (6)

如果没有给出参考格式，FromDateString 将尝试自动确定日期格式：

FromDateString[date] 等价于 FromDateString[date,Automatic]：

格式规范可以是已命名的日期格式或单个日期元素：

还可以给出明确的日期格式元素列表：

可用 "Language" 实体指定日期格式中文本元素使用的语言：

也可用 "LanguageLocale" 实体、ISO-639 语言代码或语言字符串给出语言指定：

有些语言有多种常用的书写脚本，可用 "WritingScript" 来加以区分：

可以用 ISO-15924 书写脚本代码、书写脚本字符串给出书写脚本规范，或者用 "LanguageLocale" 实体的语言规范的一部分来给出：

当给出单个分隔符时，它将被插入到每个日期格式元素之间：

当给出分隔符列表时，它们将被交织在日期格式元素之间：

地区设定也可以用作格式规范，它将使用针对该地区的适当的元素、顺序、语言、书写脚本和分隔符：

可用 "Language" 实体或 "LanguageLocale" 实体给出地区设定：

选项  (7)

CalendarType  (2)

根据输入的日期字符串生成日本日历日期：

日期字符串的输入是隐含的公历日期，所以转换将自动完成：

DateFormat  (2)

默认情况下，生成的日期将使用默认的 DateObject 日期格式：

指定 DateFormat 可确保生成对象会以相应格式给出：

指定自定义日期格式：

DateGranularity  (1)

默认情况下，FromDateString 根据输入字符串决定输出的粒度：

设置 DateGranularity"Instant" 可生成指定粒度的日期：

TimeZone  (2)

FromDateString 将尝试解析可用的时区信息，默认情况下以解析的时区返回：

如果不存在时区信息，则假定字符串位于 $TimeZone：

TimeZonezone 可用于明确指定所需的输出时区：

如果时区规格为 None，则会生成没有嵌入时区的对象：

可能存在的问题  (1)

在某些情况下，日期字符串输入可能不明确：

在这种情况下，可以使用本地时区来区分元素的预期顺序：

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

文本

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

CMS

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

APA

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

BibTeX

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

BibLaTeX

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