Funções DateValue, TimeValue e DateTimeValue

  • Artigo

Aplica-se a: Aplicações de tela Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

Converte uma data, hora ou ambas numa cadeia para um valor data/hora.

Descrição

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

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

  • A função DateTimeValue converte uma cadeia de data e hora ("10 de janeiro de 2013 00:13") num valor de data/hora.

A função DateValue ignora as informações relativas à hora da cadeia de data e a função TimeValue ignora as informações relativas à data da cadeia de hora.

Nota

As funções DateValue, TimeValue e DateTimeValue utilizam por predefinição o idioma das definições do utilizador atuais. Pode substituí-lo para assegurar que as cadeias são interpretadas corretamente. Por exemplo, "10/1/1920" é interpretado como 1 de outubro em "en" e como 10 de janeiro em "fr".

As datas têm de se encontrar num dos seguintes formatos:

  • MM/DD/AAAA ou MM-DD-AAAA
  • DD/MM/AAAA ou DD-MM-AAAA
  • AAAA/MM/DD ou AAAA-MM-DD
  • MM/DD/AA ou MM-DD-AA
  • DD/MM/AA ou DD-MM-AA
  • DD Mês AAAA
  • Mês DD, AAAA

Para converter a partir de componentes numéricos de data, mês e ano, leia Date.
Para converter a partir de componentes numéricos de hora, minuto e segundo, leia Time.

Para mais informações, leia:

Sintaxe

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

  • Cadeia – Obrigatório. Trata-se de uma cadeia de texto que contém um valor de data, hora ou de data e hora.
  • Language – Opcional. Trata-se de uma cadeia de idioma como a que seria devolvida pelos dois primeiros carateres da função Language. Se tal não for indicado, é utilizado o idioma das definições do cliente do utilizador atual.

DateValue( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

  • Sem tipo – Obrigatório. Objeto sem tipo que representa uma data ou hora. Os valores aceitáveis dependem do fornecedor sem tipo. Para JSON, espera-se que o objeto sem tipo seja uma cadeia JSON que contém uma data e hora no formato ISO 8601. As datas ou horas noutros formatos resultarão num erro. Considere converter esses valores em Texto primeiro e, em seguida, numa data ou hora. Tenha em atenção que os fusos horário e os formatos relacionados com a região são considerações importantes ao comunicar com sistemas externos.

Exemplos

DateValue

Se introduzir 10/11/2014 num controlo de introdução de texto denominado Startdate e, em seguida, definir a propriedade Text de uma etiqueta para estas fórmulas:

  • Converta uma data de uma cadeia na região do utilizador e mostre o resultado como uma data por extenso.

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

    O dispositivo definido para a região en mostra a etiqueta como Sábado, 11 de outubro de 2014.

    Nota

    Pode utilizar várias opções com a enumeração DateTimeFormat. Para apresentar uma lista de opções, escreva o parâmetro seguido por ponto ou período (.) na barra de fórmulas ou consulte Referência da função Text.

  • Converta uma data de uma cadeia na região Francês e mostre o resultado como uma data por extenso. Neste exemplo, os meses e o dia do mês são interpretados de forma diferente de Inglês.

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

    O dispositivo definido para a região en mostra a etiqueta como Segunda-feira, 10 de novembro de 2014.

Se optou por introduzir 20 de outubro de 2014:

  • Converter uma data de uma cadeia de caracteres na região do utilizador e calcular a diferença entre dois dias, em dias

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

    O dispositivo definido para a região en mostra a etiqueta como 9, indicando o número de dias entre 11 de outubro e 20 de outubro. A função DateDiff também pode apresentar a diferença em termos de meses, trimestres ou anos.

DateTimeValue

Se tiver escrito 10/11/2014 1:50:24.765 PM num controlo de introdução de texto denominado Start e, em seguida, tiver definido a propriedade Text de uma etiqueta para a seguinte fórmula:

  • Converter uma cadeia de data e hora na região atual.

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

    O dispositivo definido para a região en mostra a etiqueta como Sábado, 11 de outubro de 2014 1:50:24 PM.

    Nota

    Pode utilizar várias opções com a enumeração DateTimeFormat. Para apresentar uma lista de opções, escreva o parâmetro seguido por ponto ou período (.) na barra de fórmulas ou consulte Referência da função Text.

  • Converter uma cadeia de data e hora na região Francês. O mês e o dia do mês são interpretados de forma diferente.

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

    O dispositivo definido para a região en mostra a etiqueta como Segunda-feira, 10 de novembro de 2014 1:50:24 PM.

  • Converter uma cadeia de data e hora na região do utilizador e apresentar o resultado com um segundo fracional.

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

    O dispositivo definido para a região en mostra a etiqueta como Sábado, 11 de outubro de 2014 01:50:24.765 PM.

    Como alternativa, pode especificar hh:mm:ss.f ou hh:mm:ss.ff para arredondar a hora para o 10.o ou 100.o de segundo mais próximo.

TimeValue

Atribua o controlo de introdução de texto FinishedAt e defina a propriedade Text de uma etiqueta para esta fórmula:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Se escrever 4:59:59.999 PM no controlo FinishedAt, a etiqueta mostra "Conseguiu!"
  • Se escrever 5:00:00.000 PM no controlo FinishedAt, a etiqueta mostra "Demasiado tarde!"