parse (Método)
Analiza una cadena que contiene una fecha y devuelve el número de milisegundos transcurridos entre esa fecha y la medianoche del 1 de enero de 1970.
function parse(dateVal : {String | System.DateTime} ) : Number
Argumentos
- dateVal
Obligatorio. Una cadena que contiene una fecha con un formato del tipo "Jan 5, 1996 08:47:00" o un valor VT_DATE obtenido de un objeto ActiveX® u otro objeto.
Comentarios
El método parse devuelve un valor entero que representa el número de milisegundos transcurridos entre la medianoche del 1 de enero de 1970 y la fecha proporcionada en el argumento dateVal.
Es un método estático del objeto Date. Al ser un método estático, la llamada se realiza como se muestra en el siguiente ejemplo, en lugar de como un método de un objeto Date creado.
var datestring = "November 1, 1997 10:15 AM";
Date.parse(datestring)
Las siguientes reglas determinan lo que el método parse puede analizar satisfactoriamente:
Las fechas cortas pueden utilizar "/" o "-" como separador de fecha, pero deben seguir el formato /mes/día/año, por ejemplo "7/20/96".
Las fechas largas con el formato "July 10 1995" se pueden escribir con el año, mes y día en cualquier orden, y el año con formato de 2 ó 4 dígitos. Si se utiliza el formato de 2 dígitos, el año debe ser superior o igual a 70.
Cualquier texto entre paréntesis se trata como un comentario. Estos paréntesis se pueden anidar.
Los espacios y las comas se tratan como delimitadores. Se permite utilizar varios delimitadores.
Los nombres del mes y del día deben tener dos o más caracteres. Los nombres con dos caracteres que no son únicos se resuelven como la última coincidencia. Por ejemplo, "Ju" se resuelve como July, no como June.
El día de la semana establecido se omite si no es correcto con arreglo al resto de la fecha proporcionada. Por ejemplo, "Tuesday November 9 1996" se acepta y se analiza, aunque la fecha en cuestión sea realmente viernes. El objeto Date resultante contiene "Friday November 9 1996".
JScript permite utilizar todas las zonas horarias estándar, así como la hora universal coordinada (UTC, Universal Coordinated Time) y la hora media de Greenwich (GMT, Greenwich Mean Time).
El signo de dos puntos separa las horas, los minutos y los segundos aunque no es necesario que se especifiquen todos. " 10:", "10:11" y "10:11:12" son todos válidos.
Si se utiliza el reloj de 24 horas, es un error especificar "p.m." para horas posteriores a las 12 del mediodía. Por ejemplo, "23:15 p.m." es un error.
Una cadena que contiene una fecha no válida es un error. Por ejemplo, una cadena que contiene dos años o dos meses es un error.
Ejemplo
El siguiente ejemplo muestra el uso del método parse. Si se proporciona una fecha a la función, ésta devolverá la diferencia entre la fecha proporcionada y 1/1/1970:
function GetTimeTest(testdate){
var s, t; //Declare variables.
var MinMilli = 1000 * 60; //Initialize variables.
var HrMilli = MinMilli * 60;
var DyMilli = HrMilli * 24;
t = Date.parse(testdate); //Parse testdate.
s = "There are " //Create return string.
s += Math.round(Math.abs(t / DyMilli)) + " days "
s += "between " + testdate + " and 1/1/70";
return(s); //Return results.
}