DateTime.FromText

Sintaxe

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

Sobre

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

• Format: Um text valor que indica o formato a ser usado. Para obter mais detalhes, vá para Cadeias de caracteres de formato de data e hora padrão e Cadeias de caracteres de formato de data e hora personalizadas. Omitir este campo ou fornecer null resultará na análise da data usando o melhor esforço possível.

• 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 suportar fluxos de trabalho herdados, options também pode ser um valor de texto. Isso tem o mesmo comportamento como se options = [Format = null, Culture = options].

Exemplo 1

Converta "2010-12-31T01:30:00" em um valor de data e hora.

Utilização

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

Saída

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

Exemplo 2

Converta "2010-12-31T01:30:00.121212" em um valor de data e hora.

Utilização

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

Converta "2010-12-31T01:30:00" em um valor de data e hora.

Utilização

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

Converta "20101231T013000" em um valor de data e hora.

Utilização

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

Saída

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

Conteúdo relacionado

• Como a cultura afeta a formatação de texto
• Cadeias de caracteres de formato de data e hora padrão
• Cadeias de caracteres de formato de data e hora personalizadas