Compartilhar via

DateValue, TimeValuee DateTimeValue funções

Aplica-se a: Aplicativos de tela Copilot Studio Desktop flui aplicativos baseados em modelo CLI CLI Dataverse funções Power Pages

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

Descrição

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

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

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

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

Nota

Por DateValuepadrão, TimeValueas funções e DateTimeValue funções usam o idioma das configurações do usuário atual. Você pode substituí-lo para garantir que as cadeias de caracteres sejam interpretadas corretamente. Por exemplo, "1/10/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 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, consulte:

Sintaxe

DateValue( Cadeia de caracteres [, idioma] )
DateTimeValue( Cadeia de caracteres [, idioma ] )
TimeValue( Cadeia de caracteres [, idioma ] )

  • String - Obrigatório. Uma cadeia de caracteres de texto que contém um valor de data, hora ou uma combinação de data/hora.
  • Idioma - 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( 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 provedor 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 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ê entrar em 20 de outubro de 2014 em vez disso:

  • 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!"
  • Last updated on