Date.FromText

语法

Date.FromText(text as nullable text, optional options as any) as nullable date

关于

从文本表示形式创建日期值。

  • text:要覆盖到日期的文本值。

  • options:提供用于指定其他属性的可选 record 属性。 record 可以包含以下字段:

    • Format:一个 text 值,指示要使用的格式。 有关更多详细信息,请转到 标准日期和时间格式字符串 以及 自定义日期和时间格式字符串。 省略此字段或提供 null 使用最佳努力分析日期的结果。
    • Culture:如果 Format 不是 null, Culture 则控制某些格式说明符。 例如,in "en-US" 是,而 in "MMM" "ru-RU""янв", "фев", "мар", ..."Jan", "Feb", "Mar", ..."MMM"Formatnull 时,Culture 控制要使用的默认格式。 当 Culturenull 或被省略时,将使用 Culture.Current

若要支持旧工作流, options 也可以是文本值。 这与 options = [Format = null, Culture = options] 具有相同的行为。

示例 1

"2010-12-31" 转换为 date 值。

使用情况

Date.FromText("2010-12-31")

输出

#date(2010, 12, 31)

示例 2

使用自定义格式和德语区域性进行转换。

使用情况

Date.FromText("30 Dez 2010", [Format="dd MMM yyyy", Culture="de-DE"])

输出

#date(2010, 12, 30)

示例 3

在公历中查找与回历中 1400 开头相对应的日期。

使用情况

Date.FromText("1400", [Format="yyyy", Culture="ar-SA"])

输出

#date(1979, 11, 20)

示例 4

将“已发布日期”列中带缩写月份的意大利文本日期转换为日期值。

使用情况

let
    Source = #table(type table [Account Code = text, Posted Date = text, Sales = number],
    {
        {"US-2004", "20 gen. 2023", 580},
        {"CA-8843", "18 lug. 2024", 280},
        {"PA-1274", "12 gen. 2023", 90},
        {"PA-4323", "14 apr. 2023", 187},
        {"US-1200", "14 dic. 2023", 350},
        {"PTY-507", "4 giu. 2024", 110}
    }),
    #"Converted Date" = Table.TransformColumns(
        Source, 
        {"Posted Date", each Date.FromText(_, [Culture = "it-IT"]), type date}
    )
in
    #"Converted Date"

输出

#table(type table [Account Code = text, Posted Date = date, Sales = number],
{
    {"US-2004", #date(2023, 1, 20), 580},
    {"CA-8843", #date(2024, 7, 18), 280},
    {"PA-1274", #date(2023, 1, 12), 90},
    {"PA-4323", #date(2023, 4, 14), 187},
    {"US-1200", #date(2023, 12, 14), 350},
    {"PTY-507", #date(2024, 6, 4), 110}
})