Compartir a través de

Funciones Date, DateTime y Time

  • Artículo

Se aplica a: Aplicaciones de Canvas Flujos de Escritorio Aplicaciones basadas en modelos Power Pages 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

Fecha( Año, Mes, Día )

  • Año - Obligatorio. 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).
  • Mes - Obligatorio. Un número comprendido entre 1 y 12.
  • Día - Obligatorio. Un número comprendido entre 1 y 31.

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

  • Hora - Obligatorio. Número de horas, normalmente en el rango de 0 (12:00 a. m.) a 23 (11:00 p. m.).
  • Minuto - Obligatorio. Número de minutos, normalmente en el intervalo de 0 a 59.
  • Segundo - Obligatorio. 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.

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

  • Año - Obligatorio. 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).
  • Mes - Obligatorio. Un número comprendido entre 1 y 12.
  • Día - Obligatorio. Un número comprendido entre 1 y 31.
  • Hora - Obligatorio. Número de horas, normalmente en el rango de 0 (12:00 a. m.) a 23 (11:00 p. m.)
  • Minuto - Obligatorio. Número de minutos, normalmente en el intervalo de 0 a 59.
  • Segundo - Obligatorio. 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 llamado HireYear
  • 3 en un control de entrada de texto llamado HireMonth
  • 17 en un control de entrada de texto llamado 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 llamado BirthHour
  • 50 en un control de entrada de texto llamado BirthMinute
  • 24 en un control de entrada de texto llamado 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 llamado EclipseYear
  • 10 en un control de entrada de texto llamado EclipseMonth
  • 28 en un control de entrada de texto llamado EclipseDate
  • 13 en un control de entrada de texto llamado EclipseHour
  • 14 en un control de entrada de texto llamado EclipseMinute
  • 5 en un control de entrada de texto llamado EclipseSecond
  • 231 en un control de entrada de texto llamado EclipseMillisecond

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"
)