Clase Date

Disponibilidad

Flash Player 5.

Descripción

La clase Date permite recuperar valores de fecha y hora relativos a la hora universal (hora de Greenwich, conocida como hora universal o UTC) o relativos al sistema operativo en el que se está ejecutando Flash Player. Los métodos de la clase Date no son estáticos, pero sólo se aplican al objeto Date individual especificado cuando se llama al método. El método Date.UTC() es una excepción, ya que se trata de un método estático.

La clase Date controla el horario de verano de forma distinta en función del sistema operativo y la versión de Flash Player. Flash Player 6 y las versiones posteriores manejan el horario de verano en los sistemas operativos siguientes como se indica a continuación:

Windows: el objeto Date se ajusta automáticamente según el horario de verano. El objeto Date detecta si se emplea el horario de verano en el entorno regional actual y, si es así, detecta la fecha y la hora en que se pasa del horario estándar al horario de verano. Sin embargo, las fechas de transición que están en vigor en ese momento se aplican a fechas pasadas o futuras, de modo que puede que la diferencia horaria del horario de verano no se calcule correctamente en el caso de fechas pasadas si el entorno regional tiene fechas de transición diferentes.
Mac OS X: el objeto Date se ajusta de forma automática para el horario de verano. La base de datos de información de zonas horarias de Mac OS X sirve para determinar si a las fechas y horas pasadas o futuras se les debe aplicar una diferencia horaria debida al horario de verano.

Flash Player 5 maneja el horario de verano en estos sistemas operativos del modo siguiente:

Windows: la normativa de EE. UU. para el horario de verano siempre se aplica, lo que lleva a transiciones incorrectas en Europa y otras zonas que también tienen un horario de verano, pero cuyo momento de transición es distinto al de EE. UU. Flash detecta correctamente si el horario de verano se utiliza en el entorno regional actual.

Para llamar a los métodos de la clase Date, en primer lugar debe crear un objeto Date utilizando el constructor para la clase Date, que se describe más adelante en esta sección.

Resumen de métodos para la clase Date

Método	Descripción
`Date.getDate()`	Devuelve el día del mes según la hora local.
`Date.getDay()`	Devuelve el día de la semana según la hora local.
`Date.getFullYear()`	Devuelve el año en formato de cuatro dígitos según la hora local.
`Date.getHours()`	Devuelve la hora según la hora local.
`Date.getMilliseconds()`	Devuelve los milisegundos según la hora local.
`Date.getMinutes()`	Devuelve los minutos según la hora local.
`Date.getMonth()`	Devuelve el mes según la hora local.
`Date.getSeconds()`	Devuelve los segundos según la hora local.
`Date.getTime()`	Devuelve el número de milisegundos desde la medianoche del 1 de enero de 1970, hora universal.
`Date.getTimezoneOffset()`	Devuelve la diferencia, en minutos, entre la hora local del sistema y la hora universal.
`Date.getUTCDate()`	Devuelve el día (fecha) del mes según la hora universal.
`Date.getUTCDay()`	Devuelve el día de la semana según la hora universal.
`Date.getUTCFullYear()`	Devuelve el año en formato de cuatro dígitos según la hora universal.
`Date.getUTCHours()`	Devuelve la hora según la hora universal.
`Date.getUTCMilliseconds()`	Devuelve los milisegundos según la hora universal.
`Date.getUTCMinutes()`	Devuelve los minutos según la hora universal.
`Date.getUTCMonth()`	Devuelve el mes según la hora universal.
`Date.getUTCSeconds()`	Devuelve los segundos según la hora universal.
`Date.getYear()`	Devuelve el año según la hora local.
`Date.setDate()`	Establece el día del mes según la hora local. Devuelve la nueva hora en milisegundos.
`Date.setFullYear()`	Establece el año completo según la hora local. Devuelve la nueva hora en milisegundos.
`Date.setHours()`	Establece la hora según la hora local. Devuelve la nueva hora en milisegundos.
`Date.setMilliseconds()`	Establece los milisegundos según la hora local. Devuelve la nueva hora en milisegundos.
`Date.setMinutes()`	Establece los minutos según la hora local. Devuelve la nueva hora en milisegundos.
`Date.setMonth()`	Establece el mes según la hora local. Devuelve la nueva hora en milisegundos.
`Date.setSeconds()`	Establece los segundos según la hora local. Devuelve la nueva hora en milisegundos.
`Date.setTime()`	Establece la fecha en milisegundos. Devuelve la nueva hora en milisegundos.
`Date.setUTCDate()`	Establece la fecha según la hora universal. Devuelve la nueva hora en milisegundos.
`Date.setUTCFullYear()`	Establece el año según la hora universal. Devuelve la nueva hora en milisegundos.
`Date.setUTCHours()`	Establece la hora según la hora universal. Devuelve la nueva hora en milisegundos.
`Date.setUTCMilliseconds()`	Establece los milisegundos según la hora universal. Devuelve la nueva hora en milisegundos.
`Date.setUTCMinutes()`	Establece los minutos según la hora universal. Devuelve la nueva hora en milisegundos.
`Date.setUTCMonth()`	Establece el mes según la hora universal. Devuelve la nueva hora en milisegundos.
`Date.setUTCSeconds()`	Establece los segundos según la hora universal. Devuelve la nueva hora en milisegundos.
`Date.setYear()`	Establece el año según la hora local.
`Date.toString()`	Devuelve un valor de cadena que representa la fecha y la hora almacenada en el objeto Date especificado.
`Date.UTC()`	Devuelve el número de milisegundos entre la medianoche del 1 de enero de 1970, la hora universal, y la hora especificada.

Constructor para la clase Date

Disponibilidad

Flash Player 5.

Sintaxis

new Date()
new Date(year, month [, date [, hour [, minute [, second [, millisecond ]]]]])

Parámetros

year Valor de 0 a 99 que indica de 1900 a 1999; de lo contrario, deben especificarse los 4 dígitos del año.

month Número entero de 0 (enero) a 11 (diciembre).

date Número entero de 1 a 31. Este parámetro es opcional.

hour Número entero de 0 (medianoche) a 23 (11 PM).

minute Número entero de 0 a 59. Este parámetro es opcional.

second Número entero de 0 a 59. Este parámetro es opcional.

millisecond Número entero de 0 a 999. Este parámetro es opcional.

Valor devuelto

Ninguno.

Descripción

Objeto; construye un nuevo objeto Date que contiene la fecha y la hora actual o la fecha especificada.

Ejemplo

El ejemplo siguiente recupera la fecha y la hora actuales.

now_date = new Date();

En el ejemplo siguiente se crea un nuevo objeto Date para el día en que nació Gary: el 12 de agosto de1974. El parámetro de mes es de base cero, por lo que para el mes se utiliza 7 en lugar de 8.

garyBirthday_date = new Date (74, 7, 12);

En el ejemplo siguiente se crea un nuevo objeto Date, se concatenan los valores devueltos de Date.getMonth(), Date.getDate() y Date.getFullYear() y se visualizan en el campo de texto especificado por la variable date_str.

today_date = new Date();
date_str = ((today_date.getMonth() + 1) + "/" + today_date.getDate() + "/" + today_date.getFullYear());