Funciones Date, DateTime y Time

  • Artículo

Se aplica a: Aplicaciones de lienzo Flujos de escritorio Aplicaciones basadas en modelos Power Platform CLI

Convierte los componentes de fecha y hora en un valor de fecha y hora.

Description

La función Date convierte los valores individuales de año, mes y día en un valor de fecha y hora. La parte de la hora es la medianoche.

  • Si el año está comprendido entre 0 y 1899 (ambos incluidos), la función agrega ese valor a 1900 para calcular el año. 70 se convierte en 1970.
  • Si el valor de Mes es menor que 1 o mayor que 12, el resultado restará o sumará esos meses desde el principio del año especificado.
  • Si el valor de Día es mayor que el número de días del mes especificado, la función sumará esos días al primer día del mes y devolverá una fecha correspondiente de un mes posterior. Si el valor de Día es menor que 1, la función resta esa cantidad de días, más 1, desde el primer día del mes especificado.

La función Time convierte los valores individuales de hora, minuto, segundo y, opcionalmente, milisegundo en un valor de fecha y hora. El resultado no tiene ninguna fecha asociada a él.

La función DateTime combina las funciones de Date y Time en una sola función, tomando argumentos de fecha y hora y devolviendo un valor de Fecha/Hora que tiene componentes de fecha y hora.

Consulte las funciones DateValue, TimeValue y DateTimeValue para obtener información acerca de cómo convertir una cadena en un valor.

Consulte también cómo trabajar con fechas y horas para más información.

Sintaxis

Date( Year, Month, Day )

  • Year: requerido. Los números mayores a 1899 se interpretan como un absoluto (1980 se interpreta como 1980). Los números comprendidos entre 0 y 1899 se interpretan en relación con 1900. (Por ejemplo, 80 se interpreta como 1980).
  • Month: requerido. Un número comprendido entre 1 y 12.
  • Day: requerido. Un número comprendido entre 1 y 31.

Hora( Hora, Minuto, Segundo [, Milisegundos ] )

  • Hour: requerido. Número de horas, normalmente en el rango de 0 (12:00 a. m.) a 23 (11:00 p. m.).
  • Minute: requerido. Número de minutos, normalmente en el intervalo de 0 a 59.
  • Second: requerido. Número de segundos, normalmente en el intervalo de 0 a 59.
  • Milisegundos: opcional. Número de milisegundos, normalmente en el intervalo de 0 a 999.

DateTime( Año, Mes, Día, Hora, Minuto, Segundo [, Milisegundos ] )

  • Year: requerido. Los números mayores a 1899 se interpretan como un absoluto (1980 se interpreta como 1980). Los números comprendidos entre 0 y 1899 se interpretan en relación con 1900. (Por ejemplo, 80 se interpreta como 1980).
  • Month: requerido. Un número comprendido entre 1 y 12.
  • Day: requerido. Un número comprendido entre 1 y 31.
  • Hour: requerido. Número de horas, normalmente en el rango de 0 (12:00 a. m.) a 23 (11:00 p. m.)
  • Minute: requerido. Número de minutos, normalmente en el intervalo de 0 a 59.
  • Second: requerido. Número de segundos, normalmente en el intervalo de 0 a 59.
  • Milisegundos: opcional. Número de milisegundos, normalmente en el intervalo de 0 a 999.

Ejemplos

Date

Si un usuario escribió

  • 1979 en un control de entrada de texto denominado HireYear
  • 3 en un control de entrada de texto denominado HireMonth
  • 17 en un control de entrada de texto denominado HireDay

esta fórmula devolvería 3/17/1979:

Date( Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text) )

Tiempo

Si un usuario escribió

  • 14 en un control de entrada de texto denominado BirthHour
  • 50 en un control de entrada de texto denominado BirthMinute
  • 24 en un control de entrada de texto denominado BirthSecond

esta fórmula devolvería 02:50:24 P:

Text( 
    Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), 
    "hh:mm:ss A/P" 
)

Fecha y hora

Si un usuario escribió

  • 2023 en un control de entrada de texto denominado EclipseYear
  • 10 en un control de entrada de texto denominado EclipseMonth
  • 28 en un control de entrada de texto denominado EclipseDate
  • 13 en un control de entrada de texto denominado EclipseHour
  • 14 en un control de entrada de texto denominado EclipseMinute
  • 5 en un control de entrada de texto denominado EclipseSecond
  • 231 en un control de entrada de texto denominado EclipseMilisecond

esta fórmula devolvería 10/28/23 01:14:05.231 PM:

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)