Funções DateValue, TimeValue e DateTimeValue

Aplica-se a: Aplicativos de tela Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI

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") 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, 00:13") em um valor de data/hora.

A função DateValue ignora todas as informações de 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.

Nota

As funções DateValue, TimeValue e DateTimeValue usam por padrão o idioma das configurações atuais do usuário. Você pode substituí-lo para garantir que as cadeias de caracteres sejam interpretadas corretamente. Por exemplo, "10/1/1920" é interpretado como 1º de outubro em "en" e como 10 de janeiro em "fr".

As datas devem estar em 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 or MM-DD-AA
  • DD/MM/AA ou DD-MM-AA
  • DD Mês AAAA
  • Mês DD, AAAA

Para converter de componentes numéricos de data, mês e ano, leia Data.
Para converter de componentes numéricos de hora, minuto e segundo, leia Hora.

Para obter mais informações, leia:

Sintaxe

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

  • String - obrigatório. Uma cadeia de caracteres de texto que contém um valor de data, hora ou uma combinação de data/hora.
  • Language - opcional. Uma cadeia de caracteres de idioma, como seria retornado pelos dois primeiros caracteres da função Language. Se não for fornecido, as configurações de idioma do usuário atual serão usadas.

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

  • Untyped - obrigatório. Objeto sem tipo que representa uma data ou hora. Os valores aceitáveis dependem do provedor sem tipo. Para JSON, espera-se que o objeto sem tipo seja uma cadeia de caracteres JSON que contenha uma data e hora no formato ISO 8601. Datas ou horas em outros formatos resultarão em erro. Considere converter esses valores em Text primeiro, depois em uma data ou hora. Lembre-se de que os fusos horários e os formatos relacionados à localidade são considerações importantes ao se comunicar com sistemas externos.

Exemplos

DateValue

Se você digitou 10/11/2014 em um controle de entrada de texto chamado Startdate e definiu a propriedade Text de um rótulo para estas fórmulas:

  • Converta uma data de uma cadeia de caracteres na localidade do usuário e mostre o resultado como uma data longa.

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

    O dispositivo definido como localidade en mostra o rótulo como Sábado, 11 de outubro de 2014.

    Nota

    Você pode usar várias opções com a enumeração DateTimeFormat. Para exibir uma lista de opções, digite o parâmetro seguido de um ponto (.) na barra de fórmulas ou marque a referência de função Text.

  • Converta a data de uma cadeia de caracteres na localidade Francês e mostre o resultado como uma data longa. Neste exemplo, os meses e o dia do mês são interpretados de maneira diferente do inglês.

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

    O dispositivo definido como localidade en mostra o rótulo como Segunda-feira, 10 de novembro de 2014.

Se você digitou 20 de outubro de 2014 em vez de:

  • Converta uma data de uma cadeia de caracteres na localidade do usuário e calcule a diferença entre dois dias, em dias

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

    O dispositivo definido como a localidade en mostra o rótulo como 9, indicando o número de dias entre 11 e 20 de outubro. A função DateDiff também pode mostrar a diferença em meses, trimestres ou anos.

DateTimeValue

Se você digitou 10/11/2014 1:50:24.765 PM no controle de entrada de texto chamado Start e definiu a propriedade Text de um rótulo com a seguinte fórmula:

  • Converta uma cadeia de data e hora na localidade atual.

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

    O dispositivo definido como localidade en mostra o rótulo como Sábado, 11 de outubro de 2014 1:50:24 PM.

    Nota

    Você pode usar várias opções com a enumeração DateTimeFormat. Para exibir uma lista de opções, digite o parâmetro seguido de um ponto (.) na barra de fórmulas ou marque a referência de função Text.

  • Converta uma cadeia de data e hora na localidade Francês. Mês e dia do mês são interpretados de maneira diferente.

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

    O dispositivo definido como localidade en mostra o rótulo como Segunda-feira, 10 de novembro de 2014 1:50:24 PM.

  • Converta uma cadeia de data e hora na localidade do usuário e exiba o resultado com um segundo fracionário.

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

    O dispositivo definido como localidade en mostra o rótulo como Sábado, 11 de outubro de 2014 01:50:24.765 PM.

    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 defina a propriedade Text de um rótulo com esta fórmula:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Se você digitar 4:59:59.999 PM no controle FinishedAt, o rótulo mostrará "Você conseguiu!"
  • Se você digitar 5:00:00.000 PM no controle FinishedAt, o rótulo mostrará "Tarde demais!"