Compartir por

DateValue, TimeValue e DateTimeValue funcións

  • Artigo

Aplícase a: Aplicacións de lona Desktop flúe aplicacións Power Platform impulsadas por Modelo CLI

Converte a data, a hora ou as dúas cousas dunha cadea nun valor de data/hora.

Descripción

  • A función DateValue converte unha cadea de data (por exemplo, "01/10/2014") nun valor de data/hora.

  • A función TimeValue converte unha cadea de hora (por exemplo, "12:15 PM") nun valor de data/hora.

  • A función DataTimeValue converte unha cadea de data e hora (por exemplo, "10 de xaneiro, 2013 12:13 AM") nun valor de data/hora.

A función DateValue ignora calquera información horaria da cadea de data e a función TimeValue ignora calquera información de data da cadea de tempo.

Nota

As funcións DateValue, TimeValue e DateTimeValue usan o idioma por defecto da configuración do usuario actual. Pode anulala para asegurarse de que as cadeas se interpreten correctamente. Por exemplo, "01/10/1920" interprétase como 1 de outubro en "gl" e como 10 de xaneiro en "fr".

As datas deben estar nun 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 Mes YYYY
  • Mes DD, AAAA

Para converter os compoñentes numéricos de data, mes e ano, lea Date.
Para converter desde compoñentes numéricos de hora, minuto e segundo, lea Time.

Para obter máis información, lea:

Sintaxe

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

  • String - Obrigatorio. Cadea de texto que contén unha data, hora ou un valor de data e hora de combinación.
  • Idioma - Opcional. Unha cadea de idioma, como a devolvería os dous primeiros caracteres da función Language. Se non se especifica, úsase o idioma da configuración do usuario actual.

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

  • Untyped - Obrigatorio. Obxecto sen escribir que representa unha data ou hora. Os valores aceptables dependen do provedor non tipificado. Para JSON, espérase que o obxecto sen tipo sexa unha cadea JSON que conteña unha data e unha hora en formato ISO 8601. As datas ou horas noutros formatos producirán un erro. Considere converter eses valores a Texto primeiro e despois a data ou hora. Teña en conta que os fusos horarios e os formatos relacionados coa rexión son consideracións importantes cando se comunica con sistemas externos.

Exemplos

DateValue

Se escribe 11/10/2014 nun control de entrada de texto chamado Startdate e logo configura a propiedade Text dunha etiqueta nestas fórmulas:

  • Converta unha data dunha cadea na configuración local do usuario e mostre o resultado como unha data longa.

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

    Dispositivo configurado na configuración local gl mostra a etiqueta como Sábado, 11 de outubro de 2014.

    Nota

    Pode usar varias opcións coa enumeración DateTimeFormat. Para ver unha lista de opcións, escriba o parámetro seguido dun punto (.) na barra de fórmulas ou verifique a referencia da función Text.

  • Converta unha data dunha cadea na configuración local do francés e mostre o resultado como unha data longa. Neste exemplo, os meses e o día do mes interprétanse de xeito diferente ao inglés.

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

    Dispositivo configurado na configuración local gl mostra a etiqueta como Luns, 10 de novembro de 2014.

Se escribiu 20 de outubro de 2014 en vez diso:

  • Converta unha data a partir dunha cadea da configuración local do usuario e calcule a diferenza entre dous días, en días

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

    Dispositivo configurado na configuración rexional gl mostra a etiqueta como 9, indicando o número de días comprendidos entre o 11 e o 20 de outubro. A función DateDiff tamén pode mostrar a diferenza en meses, trimestres ou anos.

DateTimeValue

Se escribiu 11/10/2014 1:50:24.765 PM nun control de entrada de texto chamado Inicio e, a continuación, establece a propiedade Text dunha etiqueta na seguinte fórmula:

  • Converta unha cadea de data e hora da configuración local actual.

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

    Dispositivo configurado na configuración local gl mostra a etiqueta como Sábado, 11 de outubro de 2014 1:50:24 PM.

    Nota

    Pode usar varias opcións coa enumeración DateTimeFormat. Para ver unha lista de opcións, escriba o parámetro seguido dun punto (.) na barra de fórmulas ou verifique a referencia da función Text.

  • Converta unha cadea de data e hora da configuración local do francés. O mes e o día do mes interprétanse de forma diferente.

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

    Dispositivo configurado na configuración local gl mostra a etiqueta como Luns, 10 de novembro de 2014 1:50:24 PM.

  • Converta unha cadea de data e hora da configuración local do usuario e mostre o resultado cun segundo fraccionado.

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

    Dispositivo configurado na configuración local gl 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 á décima ou centésima de segundo máis próxima.

TimeValue

Asigne un control de entrada de texto FinishedAt e estableza a propiedade Text dunha etiqueta nesta fórmula:

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