Compartir a través de

DATETIME( ) (Función)

  • Artículo

Devuelve la fecha y la hora actuales como un valor DateTime o crea un valor DateTime compatible con el milenio.

DATETIME([nYear, nMonth, nDay [, nHours [, nMinutes [, nSeconds]]]])

Valores devueltos

DateTime

Parámetros

  • nYear
    Especifica el año devuelto en un valor DateTime compatible con el milenio. nYear puede tener un valor entre 100 y 9999.
  • nMonth
    Especifica el mes devuelto en un valor DateTime compatible con el milenio. nMonth puede tener un valor entre 1 y 12.
  • nDay
    Especifica el día devuelto en un valor DateTime compatible con el milenio. nDay puede tener un valor entre 1 y 31.
  • nHours
    Especifica las horas devueltas en un valor DateTime compatible con el milenio. nHours puede tener un valor entre 0 (medianoche) y 23 (11 p.m.). Toma el valor predeterminado 0 si se omite.
  • nMinutes
    Especifica los minutos devueltos en un valor DateTime compatible con el milenio. nMinutes puede tener un valor entre 0 y 59. Toma el valor predeterminado 0 si se omite.
  • nSeconds
    Especifica los segundos devueltos en un valor DateTime compatible con el milenio. nSeconds puede tomar un valor entre 0 y 59. Toma el valor predeterminado 0 si se omite.

Observaciones

DATETIME( ) devuelve la fecha actual del sistema si se ejecuta sin ningún argumento opcional. Los parámetros opcionales de fecha ausentes se sustituyen por los valores actuales del sistema. Un parámetro de hora ausente se sustituye por 12:00:00.

Incluya los argumentos opcionales para devolver un valor DateTime compatible con el año 2000 en el formato especificado en la ficha Regional del cuadro de diálogo Opciones de Visual FoxPro. Para obtener más información acerca de la creación de valores DateTime compatibles con el año 2000, vea Compatibilidad con el milenio.

Ejemplo

Este primer ejemplo almacena el valor DateTime para el Año Nuevo en una variable llamada tNewyear y almacena el valor actual de DateTime en una variable llamada tToday. Se muestra el número de segundos que hay entre el valor actual de DateTime y el Año Nuevo.

El segundo ejemplo usa DATETIME( ) para crear un valor DateTime compatible con el milenio.

tNewyear = DATETIME(YEAR(DATE( ) ) + 1, 1, 1)  && Next New Year
tToday = DATETIME()
nSecondstonewyear = tNewyear - tToday
CLEAR
? "There are " + ALLTRIM (STR(nSecondstonewyear)) ;
   + " seconds to the next New Year."

CLEAR
SET CENTURY ON
SET DATE TO AMERICAN
? DATETIME(1998, 02, 16, 12, 34, 56) && Displays 02/16/1998 12:34:56 PM

Vea también

CTOT( ) | DATE( ) | DTOT( ) | HOUR( ) | SEC( ) | SECONDS( ) | SET SECONDS | SET SYSFORMATS | TIME( ) | TTOC( ) | TTOD( )