12.5. Funciones de fecha y hora

MySQL 5.0

previous page next page

12.5. Funciones de fecha y hora

Esta sección describe las funciones que pueden usarse para manipular valores temporales. Consulte Sección 11.3, “Tipos de fecha y hora” para una descripción del rango de los valores que tiene cada fecha y hora y los formatos válidos en que se puedene especificar los valores.

Aquí hay un ejemplo que usa funciones de fecha. La siguiente consulta selecciona todos los registros con un valor dentro de los últimos 30 días: 

mysql> SELECT  FROM 
    -> WHERE DATE_SUB(CURDATE(),INTERVAL 30 DAY) <= ;

Tenga en cuenta que la consulta también selecciona registros con fechas futuras.

Las funciones que esperan valores de fecha usualmente aceptan valores de fecha y hora e ignoran la parte de hora. Las funciones que esperan valores de hora usualmente aceptan valores de fecha y hora e ignoran la parte de fecha.

Las funciones que retornan la fecha u hora actuales se evalúan sólo una vez por consulta al principio de la ejecución de consulta. Esto significa que las referencias múltiples a una función tales como en una misma consulta siempre producen el mismo resultado. Este principio también se aplica a , , , , , y a cualquiera de sus sinónimos.

En MySQL 5.0, las funciones , , , y retornan valores en la zona horaria de la conexión, que está disponible como valor de la variable de sistema . Además, asume que su argumento es un valor de fecha y hora en la zona horaria actual. Consulte Sección 5.9.8, “Soporte de zonas horarias en el servidor MySQL”.

Los rango de retorno en las siguientes descripciones de funciones se aplican en fechas completas. Si la fecha es un valor “cero” o una fecha incompleta como , las funciones que extraen una parte de la fecha pueden retornar 0. Por ejemplo retorna 0.

  • ,INTERVAL ), ,)

    Cuando se invoca con la forma del segundo argumento, es sinónimo de . La función relacionada es sinónimo de . Para información del argumento , consulte la discusión de . 

    mysql> SELECT DATE_ADD('1998-01-02', INTERVAL 31 DAY);
        -> '1998-02-02'
mysql> SELECT ADDDATE('1998-01-02', INTERVAL 31 DAY);
        -> '1998-02-02'

    Si el argumento es simplemente un valor entero, entonces MySQL 5.0 lo trata como el número de días a añadir a . 

    mysql> SELECT ADDDATE('1998-01-02', 31);
        -> '1998-02-02'

  • ,)

    añade a y retorna el resultado. es una expresión de fecha u hora y fecha, y es una expresión temporal. 

    mysql> SELECT ADDTIME('1997-12-31 23:59:59.999999',
    ->                '1 1:1:1.000002');
        -> '1998-01-02 01:01:01.000001'
mysql> SELECT ADDTIME('01:00:00.999999', '02:00:00.999998');
        -> '03:00:01.999997'

  • ,,)

    convierte un valor datetime de la zona horaria dada por a la zona horaria dada por y retorna el valor resultante. Las zonas horarias pueden especificarse como se describe en Sección 5.9.8, “Soporte de zonas horarias en el servidor MySQL”. Esta función retorna si los argumentos son inválidos.

    Si el valor se sale del rango soportado por el tipo al convertirse de a UTC, no se realiza ninguna conversión. El rango se describe en Sección 11.1.2, “Panorámica de tipos de fechas y hora”. 

    mysql> SELECT CONVERT_TZ('2004-01-01 12:00:00','GMT','MET');
        -> '2004-01-01 13:00:00'
mysql> SELECT CONVERT_TZ('2004-01-01 12:00:00','+00:00','+10:00');
        -> '2004-01-01 22:00:00'

    Nota: Para usar zonas horarias con nombres tales como o , las tabas de zona horaria deben estar actualizadas correctamente. Consulte Sección 5.9.8, “Soporte de zonas horarias en el servidor MySQL” para instrucciones.

  • Retorna la fecha horaria como valor en formato o , dependiendo de si la fucnión se usa en un contexto numérico o de cadena de carácteres. 

    mysql> SELECT CURDATE();
        -> '1997-12-15'
mysql> SELECT CURDATE() + 0;
        -> 19971215

  • ,

    y son sinónimos de .

  • Retorna la hora actual como valor en formato o dependiendo de si la fucnión se usa en un contexto numérico o de cadena de carácteres. 

    mysql> SELECT CURTIME();
        -> '23:50:26'
mysql> SELECT CURTIME() + 0;
        -> 235026

  • ,

    y son sinónimos de .

  • ,

    son sinónimos de .

  • )

    Extrae la parte de fecha de la expresión de fecha o fecha y hora . 

    mysql> SELECT DATE('2003-12-31 01:02:03');
        -> '2003-12-31'

  • ,)

    retorna el número de días entre la fecha inicial y la fecha final . y son expresiones de fecha o de fecha y hora. Sólo las partes de fecha de los valores se usan en los cálculos. 

    mysql> SELECT DATEDIFF('1997-12-31 23:59:59','1997-12-30');
        -> 1
mysql> SELECT DATEDIFF('1997-11-30 23:59:59','1997-12-31');
        -> -31

  • ,INTERVAL ), ,INTERVAL )

    Estas funciones realizan operaciones aritméticas de fechas. es un valor o especificando la fecha de inicio. es una expresión que especifica el intervalo a añadir o borrar de la fecha de inicio. es una cadena; puede comenzar con un '' para intervalos negativos. es una palabra clave que indica cómo debe interpretarse la expresión.

    La palabra clave y el especificador no son sensibles a mayúsculas.

    La siguiente tabla muestra cómo se relacionan los argumentos y :

    Value Expected Format

    Los valores y están disponibles a partir de MySQL 5.0.0.

    MySQL permite cualquier delimitador en el formato . Los mostrados en la tabla son sugerencias. Si el argumento es un valora y sus cálculos involucarán sólo partes , , y (esto es, sin partes de hora), el resultado es un valor . De otro modo, el resultado es un valor .

    se permite en cualquier lado del operador si la expresión en el otro lado es una fecha o fecha y hora. Para el operador , se permite sólo en la parte derecha, ya que no tiene sentido restar una fecha de un intervalo. (Consulte los ejemplos a continuación.) 

    mysql> SELECT '1997-12-31 23:59:59' + INTERVAL 1 SECOND;
        -> '1998-01-01 00:00:00'
mysql> SELECT INTERVAL 1 DAY + '1997-12-31';
        -> '1998-01-01'
mysql> SELECT '1998-01-01' - INTERVAL 1 SECOND;
        -> '1997-12-31 23:59:59'
mysql> SELECT DATE_ADD('1997-12-31 23:59:59',
    ->                 INTERVAL 1 SECOND);
        -> '1998-01-01 00:00:00'
mysql> SELECT DATE_ADD('1997-12-31 23:59:59',
    ->                 INTERVAL 1 DAY);
        -> '1998-01-01 23:59:59'
mysql> SELECT DATE_ADD('1997-12-31 23:59:59',
    ->                 INTERVAL '1:1' MINUTE_SECOND);
        -> '1998-01-01 00:01:00'
mysql> SELECT DATE_SUB('1998-01-01 00:00:00',
    ->                 INTERVAL '1 1:1:1' DAY_SECOND);
        -> '1997-12-30 22:58:59'
mysql> SELECT DATE_ADD('1998-01-01 00:00:00',
    ->                 INTERVAL '-1 10' DAY_HOUR);
        -> '1997-12-30 14:00:00'
mysql> SELECT DATE_SUB('1998-01-02', INTERVAL 31 DAY);
        -> '1997-12-02'
mysql> SELECT DATE_ADD('1992-12-31 23:59:59.000002',
    ->            INTERVAL '1.999999' SECOND_MICROSECOND);
        -> '1993-01-01 00:00:01.000001'

    Si especifica un intervalo demasiado pequeño (no incluye todas las partes de intervalo que se esperarían de la palabra clave ), MySQL asume que ha dejado la parte más a la izquierda del valor del intervalo. Por ejemplo, si especifica un de , se espera que el valor de tenga días, horas, minutos y segundos. Si especifica un valor como '1:10', MySQL asume que las partes de día y hora no se encuentran disponibles y que el valor representa minutos y segundos. En otras palabras, se interpreta de forma que es equivalente a . Esto es análogo a la forma en que MySQL interpreta valores como representando tiempo transcurrido en lugar de la hora del día.

    Si suma o borra de un valor de fecha algo que contenga una parte de fora, el resultado se convierte automáticamente a valor fecha/hora: 

    mysql> SELECT DATE_ADD('1999-01-01', INTERVAL 1 DAY);
        -> '1999-01-02'
mysql> SELECT DATE_ADD('1999-01-01', INTERVAL 1 HOUR);
        -> '1999-01-01 01:00:00'

    Si usa fechas muy mal formadas, el resultado es . Si suma , , o y la fecha resultante tiene un día mayor que el día máximo para el nuevo mes, el día se ajusta al número máximo del nuevo mes: 

    mysql> SELECT DATE_ADD('1998-01-30', INTERVAL 1 MONTH);
        -> '1998-02-28'

  • ,)

    Formatea el valor según la cadena . Los siguientes especificadores pueden usarse en la cadena :

    Especificador Descripción
    Día de semana abreviado (..)
    Mes abreviado (..)
    Mes, numérico (..)
    Día del mes con sufijo inglés (, , , , ...)
    Día del mes numérico (..)
    Día del mes numérico (..)
    Microsegundos (..)
    Hora (..)
    Hora (..)
    Hora (..)
    Minutos, numérico (..)
    Día del año (..)
    Hora (..)
    Hora (..)
    Nombre mes (..)
    Mes, numérico (..)
    o
    Hora, 12 horas ( seguido de o )
    Segundos (..)
    Segundos (..)
    Hora, 24 horas ()
    Semana (..), donde domingo es el primer día de la semana
    Semana (..), donde lunes es el primer día de la semana
    Semana (..), donde domingo es el primer día de la semana; usado con
    Semana (..), donde lunes es el primer día de la semana; usado con
    Nombre día semana (..)
    Día de la semana (=Sunday..=Saturday)
    Año para la semana donde domingo es el primer día de la semana, numérico, cuatro dígitos; usado con
    Año para la semana, donde lunes es el primer día de la semana, numérico, cuatro dígitos; usado con
    Año, numérico, cuatro dígitos
    Año, numérico (dos dígitos)
    Carácter '' literal

    Todos los otros carácteres se copian al resultado sin interpretación.

    Tenga en cuenta que el carácter '' se necesita antes de carácteres especificadores de formato.

    Los rangos para los especificadores de mes y día comienzan en cero debido a que MySQL permite almacenar fechas incompletas tales como . 

    mysql> SELECT DATE_FORMAT('1997-10-04 22:23:00', '%W %M %Y');
        -> 'Saturday October 1997'
mysql> SELECT DATE_FORMAT('1997-10-04 22:23:00', '%H:%i:%s');
        -> '22:23:00'
mysql> SELECT DATE_FORMAT('1997-10-04 22:23:00',
                          '%D %y %a %d %m %b %j');
        -> '4th 97 Sat 04 10 Oct 277'
mysql> SELECT DATE_FORMAT('1997-10-04 22:23:00',
                          '%H %k %I %r %T %S %w');
        -> '22 22 10 10:23:00 PM 22:23:00 00 6'
mysql> SELECT DATE_FORMAT('1999-01-01', '%X %V');
        -> '1998 52'

  • )

    es sinónimo de .

  • )

    Retorna el nombre del día de la semana para . 

    mysql> SELECT DAYNAME('1998-02-05');
        -> 'Thursday'

  • )

    Retorna el día del mes para , en el rango a . 

    mysql> SELECT DAYOFMONTH('1998-02-03');
        -> 3

  • )

    Retorna el índice del día de la semana para (1 = lunes, 2 = martes, ..., 7 = sábado). Estos valores del índice se corresponden con el estándar ODBC. 

    mysql> SELECT DAYOFWEEK('1998-02-03');
        -> 3

  • )

    Retorna el día del año para , en el rango 1 a 366. 

    mysql> SELECT DAYOFYEAR('1998-02-03');
        -> 34

  • FROM )

    La función usa la misma clase de especificadores de tipo que o , pero extrae partes de la fecha en lugar de realizar aritmética de fecha. 

    mysql> SELECT EXTRACT(YEAR FROM '1999-07-02');
       -> 1999
mysql> SELECT EXTRACT(YEAR_MONTH FROM '1999-07-02 01:02:03');
       -> 199907
mysql> SELECT EXTRACT(DAY_MINUTE FROM '1999-07-02 01:02:03');
       -> 20102
mysql> SELECT EXTRACT(MICROSECOND
    ->                FROM '2003-01-02 10:30:00.00123');
        -> 123

  • )

    Dado un número de día , retorna un valor . 

    mysql> SELECT FROM_DAYS(729669);
        -> '1997-10-07'

    Use con precaución en fechas viejas. No se pretende que se use con valores que precedan el calendario Gregoriano (1582). Consulte Sección 12.6, “Qué calendario utiliza MySQL”.

  • ) , ,)

    Retorna una representación del argumento como un valor en formato o , dependiendo de si la función se usa en un formato numérico o de cadena de carácteres. 

    mysql> SELECT FROM_UNIXTIME(875996580);
        -> '1997-10-04 22:23:00'
mysql> SELECT FROM_UNIXTIME(875996580) + 0;
        -> 19971004222300

    Si se da , el resultado se formatea según la cadena . puede contener los mismos especificadores que los listados en la entrada para la función . 

    mysql> SELECT FROM_UNIXTIME(UNIX_TIMESTAMP(),
    ->                      '%Y %D %M %h:%i:%s %x');
        -> '2003 6th August 06:22:58 2003'

  • Retorna una cadena de formato. Esta función es útil en combinación con las funciones y .

    Los tres valores posibles para el primer argumento y los cinco posibles valores para el segundo argumento resultan en 15 posibles cadenas de formato (para los especificadores usados, consulte la tabla en la descripción de la función ).

    LLamad a función Resultado

    El formato ISO es ISO 9075, no ISO 8601.

    En MySQL 5.0, puede usarse; retorna los mismos valores que para . 

    mysql> SELECT DATE_FORMAT('2003-10-03',GET_FORMAT(DATE,'EUR'));
        -> '03.10.2003'
mysql> SELECT STR_TO_DATE('10.31.2003',GET_FORMAT(DATE,'USA'));
        -> '2003-10-31'

    Consulte Sección 13.5.3, “Sintaxis de ”.

  • )

    Retorna la hora para . El rango del valor de retorno es 0 a 23 para valores de horas del día. 

    mysql> SELECT HOUR('10:05:03');
        -> 10

    Además, el rango de los valores es mucho mayor, así que puede retornar valores mayores que . 

    mysql> SELECT HOUR('272:59:59');
        -> 272

  • )

    Toma una fecha o fecha/hora y retorna el valor correspondiente para el último día del mes. Retorna si el argumento es inválido. 

    mysql> SELECT LAST_DAY('2003-02-05');
        -> '2003-02-28'
mysql> SELECT LAST_DAY('2004-02-05');
        -> '2004-02-29'
mysql> SELECT LAST_DAY('2004-01-01 01:01:01');
        -> '2004-01-31'
mysql> SELECT LAST_DAY('2003-03-32');
        -> NULL

  • ,

    y son sinónimos de .

  • ,

    y son sinónimos de .

  • ,)

    Retorna una fecha, dado un año y día del año. debe ser mayor a 0 o el resultado es . 

    mysql> SELECT MAKEDATE(2001,31), MAKEDATE(2001,32);
        -> '2001-01-31', '2001-02-01'
mysql> SELECT MAKEDATE(2001,365), MAKEDATE(2004,365);
        -> '2001-12-31', '2004-12-30'
mysql> SELECT MAKEDATE(2001,0);
        -> NULL

  • ,,)

    Retorna un valor horario calculado a partir de los argumentos , , y . 

    mysql> SELECT MAKETIME(12,15,30);
        -> '12:15:30'

  • )

    Retorna los microsegundos a partir del a expresión de hora o fecha/hora como número en el rango de a . 

    mysql> SELECT MICROSECOND('12:00:00.123456');
        -> 123456
mysql> SELECT MICROSECOND('1997-12-31 23:59:59.000010');
        -> 10

  • )

    Retorna el minuto de , en el rango a . 

    mysql> SELECT MINUTE('98-02-03 10:05:03');
        -> 5

  • )

    Retorna el mes para , en el rango a . 

    mysql> SELECT MONTH('1998-02-03');
        -> 2

  • )

    Retorna el nombre completo del mes para . 

    mysql> SELECT MONTHNAME('1998-02-05');
        -> 'February'

  • Retorna la fecha y hora actual como valor en formato o , dependiendo de si la función se usa en contexto numérico o de cadena de carácteres. 

    mysql> SELECT NOW();
        -> '1997-12-15 23:50:26'
mysql> SELECT NOW() + 0;
        -> 19971215235026

  • ,)

    Añade meses al periodo (en el formato o ). Retorna un valor en el formato . Tenga en cuenta que el argumento del periodo no es una fecha. 

    mysql> SELECT PERIOD_ADD(9801,2);
        -> 199803

  • ,)

    Retorna el número de meses entre periodos y . y deben estar en el formato o . Tenga en cuenta que los argumentos del periodo y no son fechas. 

    mysql> SELECT PERIOD_DIFF(9802,199703);
        -> 11

  • )

    Retorna el cuarto del año para , en el rango a . 

    mysql> SELECT QUARTER('98-04-01');
        -> 2

  • )

    Retorna el segundo para , en el rango a . 

    mysql> SELECT SECOND('10:05:03');
        -> 3

  • )

    Retorna el argumento , convertido a horas, minutos y segundos, como un valor en formato o , dependiendo de si la función se usa en contexto numérico o de cadena de carácteres. 

    mysql> SELECT SEC_TO_TIME(2378);
        -> '00:39:38'
mysql> SELECT SEC_TO_TIME(2378) + 0;
        -> 3938

  • ,)

  • Esta es la inversa de la función . Toma la cadena y la cadena de formato . retorna un valor si la cadena de formato contiene parte de fecha y hora, o un valor o si la cadena contiene sólo parte de fecha o hora.

    Los valores fecha, hora o fecha/hora contenidos en deben ser dados en el formato indicado por . Para los especificadores que pueden usarse en , consulte la tabla en la descripción de la función . Todos los otros carácteres no se interpretan. Si contiene un valor fecha, hora o fecha/hora ilegal, retorna . A partir de MySQL 5.0.3, un valor ilegal también produce una advertencia. 

    

mysql> SELECT STR_TO_DATE('03.10.2003 09.20','%d.%m.%Y %H.%i');
        -> '2003-10-03 09:20:00'
mysql> SELECT STR_TO_DATE('10arp', '%carp');
        -> '0000-10-00 00:00:00'
mysql> SELECT STR_TO_DATE('2003-15-10 00:00:00','%Y-%m-%d %H:%i:%s');
        -> NULL

    El chequeo de rango en las partes de los valores de fecha se describe en Sección 11.3.1, “Los tipos de datos , y ”. Esto significa, por ejemplo, que una fecha con una parte de día mayor que el número de días en un mes se permite mientras la parte del día esté en el rango de 1 a 31. También, fechas “cero” o fechas con partes de 0 se permiten. 

    mysql> SELECT STR_TO_DATE('00/00/0000', '%m/%d/%Y');
        -> '0000-00-00'
mysql> SELECT STR_TO_DATE('04/31/2004', '%m/%d/%Y');
        -> '2004-04-31'

  • ,INTERVAL ), ,)

    Cuando se invoca con la forma del segundo argumento, es sinónimo de . Para información del argumento , consulte la discusión para . 

    mysql> SELECT DATE_SUB('1998-01-02', INTERVAL 31 DAY);
        -> '1997-12-02'
mysql> SELECT SUBDATE('1998-01-02', INTERVAL 31 DAY);
        -> '1997-12-02'

    La siguiente forma permite el uso de un valor entero para . En tales casos, es el número de días a ser borrados de la expresión fecha o fecha/hora . 

    mysql> SELECT SUBDATE('1998-01-02 12:00:00', 31);
        -> '1997-12-02 12:00:00'

    Nota no puede usar formato para convertir una cadena año-semana en fecha ya que la combinación de un año y semana no identific unívocamente un año y semana si la semana atraviesa la forntera de un mes. Para convertir un año-semana a fecha, debe especificar el día de la semana: 

    mysql> select str_to_date('200442 Monday', '%X%V %W');
-> 2004-10-18

  • ,)

    resta de y retorna el resultado. es una expresión de hora o fecha/hora, y es una expresión de hora. 

    mysql> SELECT SUBTIME('1997-12-31 23:59:59.999999','1 1:1:1.000002');
        -> '1997-12-30 22:58:58.999997'
mysql> SELECT SUBTIME('01:00:00.999999', '02:00:00.999998');
        -> '-00:59:59.999999'

  • es sinónimo de .

  • )

    Extrae la parte de hora de la expresión hora o fecha/hora . 

    mysql> SELECT TIME('2003-12-31 01:02:03');
        -> '01:02:03'
mysql> SELECT TIME('2003-12-31 01:02:03.000123');
        -> '01:02:03.000123'

  • ,)

    retorna el tiempo entre la hora de inicio y la hora final . y son expresiones de hora o de fecha/hora, pero ambas deben ser del mismo tipo. 

    mysql> SELECT TIMEDIFF('2000:01:01 00:00:00',
    ->                 '2000:01:01 00:00:00.000001');
        -> '-00:00:00.000001'
mysql> SELECT TIMEDIFF('1997-12-31 23:59:59.000001',
    ->                 '1997-12-30 01:01:01.000002');
        -> '46:58:57.999999'

  • ) , ,)

    Con un único argumento, esta función retorna la expresión de fecha o fecha/hora como valor fecha/hora. Con dos argumentos, suma la expresión de hora a la expresión de fecha o de fecha/hora y retorna el resultado como valor fecha/hora. 

    mysql> SELECT TIMESTAMP('2003-12-31');
        -> '2003-12-31 00:00:00'
mysql> SELECT TIMESTAMP('2003-12-31 12:00:00','12:00:00');
        -> '2004-01-01 00:00:00'

  • ,,)

    Suma la expresión entera a la expresión de fecha o de fecha/hora . La unidad for la da el argumento , que debe ser uno de los siguientes valores: , , , , , , , , o .

    El valor puede especificarse usando una de las palabras claves que se muestran, o con un prefijo de . Por ejemplo, o son legales. 

    mysql> SELECT TIMESTAMPADD(MINUTE,1,'2003-01-02');
        -> '2003-01-02 00:01:00'
mysql> SELECT TIMESTAMPADD(WEEK,1,'2003-01-02');
        -> '2003-01-09'

    está disponible desde MySQL 5.0.0.

  • ,,)

    Retorna la diferencia entera entre las expresiones de fecha o de fecha/hora y . La unidad del resultado se da en el argumento . Los valores legales para son los mismos que los listados en la descripción de la función . 

    mysql> SELECT TIMESTAMPDIFF(MONTH,'2003-02-01','2003-05-01');
        -> 3
mysql> SELECT TIMESTAMPDIFF(YEAR,'2002-05-01','2001-01-01');
        -> -1

    está disponible desde MySQL 5.0.0.

  • ,)

    Se usa como la función pero la cadena puede contener sólo los especificadores de formato que tratan horas, minutos y segundos. Otros especificadores producen un valor o .

    Si el valor contiene una parte horaria mayor que , los especificadores de formato horario y producen un valor mayor que el rango usual de . Los otros especificadores de hora producen la hora modulo 12. 

    mysql> SELECT TIME_FORMAT('100:00:00', '%H %k %h %I %l');
        -> '100 100 04 04 4'

  • )

    Retorna el argumento convertido en segundos. 

    mysql> SELECT TIME_TO_SEC('22:23:00');
        -> 80580
mysql> SELECT TIME_TO_SEC('00:39:38');
        -> 2378

  • )

    Dada la fecha , retorna un número de día (el número de dias desde el año 0). 

    mysql> SELECT TO_DAYS(950501);
        -> 728779
mysql> SELECT TO_DAYS('1997-10-07');
        -> 729669

    no está pensado para usarse con valores anteriores al calendario Gregoriano (1582), ya que no tiene en cuenta los días perdidos cuando se cambió el calendario. Consulte Sección 12.6, “Qué calendario utiliza MySQL”.

    Recuerde que MySQL convierte años de dos dígitos en fechas de cuatro dígitos usando las reglas en Sección 11.3, “Tipos de fecha y hora”. Por ejemplo, y se consideran fechas idénticas: 

    mysql> SELECT TO_DAYS('1997-10-07'), TO_DAYS('97-10-07');
        -> 729669, 729669

    Para fechas anteriores a 1582 (y posiblemente un año posterior en otras localizaciones), los resultados de esta función no son fiables. Consulte Sección 12.6, “Qué calendario utiliza MySQL” para más detalles.

  • , )

    Si se llama sin argumentos, retorna el timestamp de Unix (segundos desde GMT) como entero sin signo. Si se llama a con un argumento , retorna el valor del argumento como segundos desde GMT. puede ser una cadena , una cadena , un , o un número en el formato o en hora local. 

    mysql> SELECT UNIX_TIMESTAMP();
        -> 882226357
mysql> SELECT UNIX_TIMESTAMP('1997-10-04 22:23:00');
        -> 875996580

    Cuando se usa en una columna , la función retorna el valor del timestamp interno directamente, sin conversión implícita “string-to-Unix-timestamp” . Si pasa una fecha fuera de rango a , retorna , pero tenga en cuenta que sólo se hace un chequeo de rango básico (año de a , mes de a , día de a ).

    Si quiere restar columnas puede querer convertir el resultado a enteros sin signo. Consulte Sección 12.8, “Funciones y operadores de cast”.

  • ,

    Retorna la fecha UTC actual como valor en formato o , dependiendo si la función se usa en un contexto numérico o de cadenas de carácteres. 

    mysql> SELECT UTC_DATE(), UTC_DATE() + 0;
        -> '2003-08-14', 20030814

  • ,

    Retorna la hora UTC actual como valor en formato or dependiendo si la función se usa en un contexto numérico o de cadenas de carácteres. 

    mysql> SELECT UTC_TIME(), UTC_TIME() + 0;
        -> '18:07:53', 180753

  • ,

    Retorna la fecha y hora UTC actual como valor en formato o dependiendo si la función se usa en un contexto numérico o de cadenas de carácteres. 

    mysql> SELECT UTC_TIMESTAMP(), UTC_TIMESTAMP() + 0;
        -> '2003-08-14 18:08:04', 20030814180804

  • [,])

    Esta función retorna el número de semana para . La forma de dos argumentos de le permite especificar si la semana comienza en lunes o domingo y si el valor de retorno debe estar en el rango de a o de a . Si el argumento se omite en MySQL 5.0, el valor de la variable de sistema se usa. Consulte Sección 5.3.3, “Variables de sistema del servidor”.

    La siguiente tabla describe cómo funciona el argumento :

      Primer día    
    Modo de semana Rango Semana 1 es la primera semana...
    0 Domingo 0-53 con un domingo en este año
    1 Lunes 0-53 con más de 3 días este año
    2 Domingo 1-53 con un domingo este año
    3 Lunes 1-53 con más de 3 días este año
    4 Domingo 0-53 con más de 3 días este año
    5 Lunes 0-53 con un lunes en este año
    6 Domingo 1-53 con más de 3 días este año
    7 Lunes 1-53 con un lunes en este año 
    mysql> SELECT WEEK('1998-02-20');
        -> 7
mysql> SELECT WEEK('1998-02-20',0);
        -> 7
mysql> SELECT WEEK('1998-02-20',1);
        -> 8
mysql> SELECT WEEK('1998-12-31',1);
        -> 53

    Tenga en cuenta que si una fecha cae en la última semana del año prévio, MySQL retorna si no usa , , , o con el argumento opcional : 

    mysql> SELECT YEAR('2000-01-01'), WEEK('2000-01-01',0);
        -> 2000, 0

    Se podría argumentar que MySQL debería retornar para la función , ya que la fecha dada ocurre en la 52a semana de 1999. Decidimos retornar en su lugar porque queríamos que la función devolviera “el número de semana en el año dado.” Esta hace uso de la función fiable combinada con otras funciones que extraen una parte de fecha de una fecha.

    Si prefiere que el resultado a ser evaluado respecto al año que contiene el primer día de la semana para la fecha dada, debe usar , , , o como el argumento opcional. 

    mysql> SELECT WEEK('2000-01-01',2);
        -> 52

    Alternativamente, use la función : 

    mysql> SELECT YEARWEEK('2000-01-01');
        -> 199952
mysql> SELECT MID(YEARWEEK('2000-01-01'),5,2);
        -> '52'

  • )

    Retorna el índice de días de la semana para ( = lunes, = martes, ... = domingo). 

    mysql> SELECT WEEKDAY('1998-02-03 22:23:00');
        -> 1
mysql> SELECT WEEKDAY('1997-11-05');
        -> 2

  • )

    Retorna la semana de la fecha como número del rango a . Esta es una función de compatibilidad equivalente a ,3). 

    mysql> SELECT WEEKOFYEAR('1998-02-20');
        -> 8

  • )

    Retorna el año para , en el rango a . 

    mysql> SELECT YEAR('98-02-03');
        -> 1998

  • ), ,)

    Retorna año y semana para una fecha. El argumento funciona exactamente como el argumento de . El año en el resultado puede ser diferente del año en el argumento fecha para la primera y última semana del año. 

    mysql> SELECT YEARWEEK('1987-01-01');
        -> 198653

    Tenga en cuenta que el número de semana es diferente de lo que la función retornaría () para argumentos opcionales o , como retorna la semana en el contexto del año dado.

previous page start next page