Compartilhar via


DateTime.FromText

Sintaxe

DateTime.FromText(text as nullable text, optional options as any) as nullable datetime

Sobre

Cria um valor datetime com base em uma representação textual, text. Um parâmetro de record opcional, options, pode ser fornecido para especificar propriedades adicionais. O record pode conter os seguintes campos:

  • Format: um valor text que indica o formato a ser usado. Para obter mais detalhes, acesse https://go.microsoft.com/fwlink/?linkid=2180104 e https://go.microsoft.com/fwlink/?linkid=2180105. Omitir esse campo ou fornecer null resultará na análise da data usando um melhor esforço.

  • Culture: quando Format não é nulo, Culture controla alguns especificadores de formato. Por exemplo, em "en-US""MMM" é "Jan", "Feb", "Mar", ..., enquanto em "ru-RU""MMM" é "янв", "фев", "мар", .... Quando Format é null, Culture controla o formato padrão a ser usado. Quando Culture é null ou omitido, Culture.Current é usado.

Para dar suporte a fluxos de trabalho herdados, options também podem ser um valor de texto. Isso tem o mesmo comportamento que options = [Format = null, Culture = options].

Exemplo 1

Converter "2010-12-31T01:30:00" em um valor de datetime.

Usage

DateTime.FromText("2010-12-31T01:30:25")

Saída

#datetime(2010, 12, 31, 1, 30, 25)

Exemplo 2

Converter "2010-12-31T01:30:00.121212" em um valor de datetime.

Usage

DateTime.FromText("30 Dez 2010 02:04:50.369730", [Format="dd MMM yyyy HH:mm:ss.ffffff", Culture="de-DE"])

Saída

#datetime(2010, 12, 30, 2, 4, 50.36973)

Exemplo 3

Converter "2010-12-31T01:30:00" em um valor de datetime.

Usage

DateTime.FromText("2000-02-08T03:45:12Z", [Format="yyyy-MM-dd'T'HH:mm:ss'Z'", Culture="en-US"])

Saída

#datetime(2000, 2, 8, 3, 45, 12)

Exemplo 4

Converter "20101231T013000" em um valor de datetime.

Usage

DateTime.FromText("20101231T013000", [Format="yyyyMMdd'T'HHmmss", Culture="en-US"])

Saída

#datetime(2010, 12, 31, 1, 30, 0)