Converte uma data, hora ou ambas em uma cadeia de caracteres para um valor de data/hora.

Descrição

A função DateValue converte uma cadeia de caracteres de data (por exemplo, "01/10/2014") em um valor de data/hora.

A função TimeValue converte uma cadeia de caracteres de hora (por exemplo, "12:15 PM") em um valor de data/hora.

A função DateTimeValue converte uma cadeia de caracteres de data e hora (por exemplo, "10 de janeiro de 2013, 12:13") em um valor de data/hora.

A função DateValue ignora todas as informações sobre a hora na cadeia de caracteres de data e a função TimeValue ignora todas as informações de data na cadeia de caracteres de hora.

Por padrão, a linguagem usada é a mesma do usuário atual, mas você pode substituí-la para garantir que as cadeias de caracteres são interpretadas corretamente. Por exemplo, "10/1/1920" é interpretado como 1º de outubro em "en" (inglês) e como 10 de janeiro em "fr" (francês).

As datas devem estar em um destes formatos:

  • MM/DD/AAAA
  • DD/MM/AAAA
  • DD Mês AAAA
  • Mês DD, AAAA

Consulte as funções Date e Time para converter data, mês e ano e a hora, minuto e segundo a partir de componentes numéricos.

Consulte também Trabalhar com datas e horas para obter mais informações.

Para converter números, consulte a função Value.

Sintaxe

DateValue( String [, Idioma ])
DateTimeValue( String [, Idioma ])
TimeValue( String [, Idioma ])

  • String - obrigatório. Uma cadeia de caracteres de texto que contém um valor de data e hora ou uma combinação de ambas.
  • Idioma - opcional. Uma cadeia de caracteres de idioma, como seria retornado pelos dois primeiros caracteres da função Language. Se não fornecido, o idioma do cliente do usuário atual será usado.

Exemplos

DateValue

Se você digitou 11/10/2014 em um controle de entrada de texto chamado Startdate e definiu a propriedade Text de um rótulo com esta função:

  • Text(DateValue(Startdate.Text), DateTimeFormat.LongDate)

    O rótulo deve mostrar Sábado, 11 de outubro de 2014, se o seu computador foi configurado para a localidade en.

    Observação: Você pode usar várias opções diferentes de LongDateTime, com o parâmetro DateTimeFormat. Para exibir uma lista dessas opções, digite o parâmetro, seguido de um ponto de exclamação, na caixa de função.

  • Text(DateValue(Startdate.Text, "fr"), DateTimeFormat.LongDate)

    O rótulo deve mostrar Segunda-feira, 10 de novembro de 2014.

Se você fez a mesma coisa em 20 de outubro de 2014:

  • DateDiff(DateValue(Startdate.Text), Today())

    Se o computador estivesse definido para o idioma en, o rótulo mostra 9, que indica o número de dias entre 11 de outubro e 20 de outubro. A função DateDiff também pode mostrar a diferença em meses, trimestres ou anos.

DateTimeValue

Se você digitou 11/10/2014 1h50min24,765s em um controle de texto de entrada chamado Start e definiu a propriedade Text de um rótulo com esta função:

  • Text(DateTimeValue(Start.Text), DateTimeFormat.LongDateTime)

    O rótulo deve mostrar Sábado, 11 de outubro de 2014 1:50:24 PM, se o seu computador foi configurado para a localidade “en”.

    Observação: Você pode usar várias opções diferentes de LongDateTime, com o parâmetro DateTimeFormat. Para exibir uma lista dessas opções, digite o parâmetro, seguido de um ponto de exclamação, na caixa de função.

  • Text(DateTimeValue(Start.Text, "fr"), DateTimeFormat.LongDateTime)

    O rótulo deve mostrar Segunda-feira, 10 de novembro de 2014 1:50:24 PM.

  • Text(DateTimeValue(Start.Text), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM")

    O rótulo deve mostrar Sábado, 11 de outubro de 2014 01:50:24:765 PM, se o seu computador foi configurado para a localidade en.

    Como alternativa, você pode especificar hh:mm:ss.f ou hh:mm:ss.ff para arredondar a hora para o décimo ou centésimo de segundo mais próximo.

TimeValue

Nomeie um controle de entrada de texto FinishedAt e, depois, defina a propriedade Text de um rótulo com esta função:

If(TimeValue(FinishedAt.Text)<TimeValue("5:00:00.000 PM"), "Você chegou na hora!", "Você está atrasado!")

  • Se você digitar 4:59:59.999 PM no controle FinishedAt, o rótulo mostra "Você chegou na hora!"

  • Se você digitar 5:00:00.000 PM no controle FinishedAt, o rótulo mostra "Você está atrasado!"