Funções DateValue, TimeValue e DateTimeValue no Power Apps

Artigo
03/09/2022
2 minutos para o fim da leitura

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.

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 décimo ou centésimo 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!"