Partilhar via

DateValue, TimeValue, e DateTimeValue funções

Aplica-se a: Aplicativos de tela Copilot Studio Fluxos de ambiente de trabalho Aplicações orientadas por modelos Funções do Power Platform CLI Dataverse Power Pages

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

Descrição

  • DateValue converte uma cadeia de caracteres de data (como "10/01/2014") em um valor de data/hora .

  • TimeValue converte uma cadeia de caracteres de hora (como "12:15 PM") em um valor de data/hora .

  • DateTimeValue converte uma cadeia de caracteres de data e hora (como "10 de janeiro de 2013 12:13") em um valor de data/hora .

DateValue function ignora qualquer informação de hora na cadeia de caracteres de data, e TimeValue função ignora qualquer informação de data na cadeia de caracteres de hora.

Nota

As DateValuefunções , TimeValuee por DateTimeValue padrão usam o idioma das configurações do usuário atual. 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 devem usar um destes 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 obter mais informações, consulte:

Sintaxe

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

  • string - obrigatório. Trata-se de uma cadeia de texto que contém um valor de data, hora ou de data e hora.
  • Idioma - 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( Dinâmico )
DateTimeValue( Dinâmico )
TimeValue( Dinâmico )

  • Dinâmico - Obrigatório. Valor dinâmico que representa uma data ou hora. Os valores aceitáveis dependem do fornecedor sem tipo. Para JSON, espera-se que o valor dinâmico seja uma cadeia de caracteres JSON que contenha uma data e hora no formato ISO 8601. Datas ou horas em outros formatos resultam em um 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 você inserir 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!"
  • Last updated on