Provided by: manpages-es_1.55-10_all bug

NOMBRE

       getdate() - convierte una cadena a una estructura tm

SINOPSIS

       #define _XOPEN_SOURCE
       #define _XOPEN_SOURCE_EXTENDED
       #include <time.h>

       struct tm *getdate (const char *string);

       extern int getdate_err;

       #define _GNU_SOURCE
       #include <time.h>

       int getdate_r (const char *string, struct tm *res);

DESCRIPCI'ON

       La  funcion  getdate()  convierte  la cadena apuntada por string en una
       estructura tm que es devuelta por la funcion.  Esta estructura tm puede
       encontrarse   en   almacenamiento   estatico,  por  lo  que  puede  ser
       sobreescrita por una llamada posterior.

       En contraste  con  strptime(3),  (que  tiene  un  argumento  format  ),
       getdate()  usa  los  formatos  situados  en  el  fichero  del  cual  se
       especifica la ruta completa en la  variable  de  entorno  DATEMSK.   La
       primera linea del fichero que concuerde con la cadena de entrada pasada
       se utiliza para la conversion.

       La correspondencia se hace sin tener en  cuenta  las  mayusculas.   Los
       espacios  innecesarios, ya sea en el patron o en la cadena que debe ser
       convertida, se ignoran.

       Las especificaciones de conversion que puede  contener  un  patron  son
       aquellas  que proporciona strptime(3).  Se acepta una especificacion de
       conversion adicional:

       %Z     Nombre de la zona horaria.

       Cuando se proporciona %Z, el valor que se devuelve se inicializa con el
       valor  de  tiempo  descompuesto  correspondiente a la hora actual en la
       zona horaria dada.  En otro caso, se inicializa con el valor de  tiempo
       descompuesto correspondiente a la hora local actual.

       Cuando solo se especifica el dia de la semana, el dia que se toma es el
       primero tras el dia actual (que podria ser el propio dia actual).

       Cuando solo se especifica el mes (y no el ano), el mes que se  toma  es
       el  primero  tras  el mes actual (que podria ser el propio mes actual).
       Si no se especifica el dia, se toma el primer dia del mes.

       Cuando no se dan ni hora, ni minutos, ni segundos, se  toman  la  hora,
       minutos y segundos actuales.

       Si no se especifica la fecha, pero sabemos la hora, entonces la hora se
       toma para que sea la primera tras la hora actual  (que  podria  ser  la
       propia hora actual).

VALOR DEVUELTO

       Cuando  tiene  exito, esta funcion devuelve un puntero a una estructura
       tm.  En  otro  caso,  devuelve  NULL  y  modifica  la  variable  global
       getdate_err.   Los  cambios  a  errno  son  indefinidos. Se definen los
       siguientes valores para getdate_err:

       1   La variable de entorno DATEMSK es null o no esta definida.

       2   No se ha podido abrir el fichero de plantillas para lectura.

       3   Fallo al obtener informacion del estado del fichero.

       4   El fichero de plantillas no es un fichero regular.

       5   Se ha producido un error al leer el fichero de plantillas.

       6   Fallo  en  la  reserva  de  memoria  (no  hay  suficiente   memoria
           disponible).

       7   No hay ninguna linea en el fichero que concuerde con la entrada.

       8   Especificacion invalida de entrada.

OBSERVACIONES

       Puesto que getdate() no es reentrante debido al uso de getdate_err y al
       buffer estatico que contiene el valor devuelto, glibc  proporciona  una
       variante  segura para hilos. La funcionalidad es la misma. El resultado
       es devuelto en el buffer apuntado por res y en el caso de un  error  el
       valor  devuelto  es  distinto  de  cero  con los mismos valores que los
       descritos arriba para getdate_err.

       La  especificacion   POSIX   1003.1-2001   para   strptime()   contiene
       especificaciones  de  conversion  que  usan  el  modificador  %E  o %O,
       mientras que tales especificaciones  no  se  dan  para  getdate().   La
       implementacion  de  glibc implementa getdate() usando strptime() por lo
       que automaticamente las mismas conversiones son soportadas por ambas.

       La implementacion de glibc no soporta la especificacion  de  conversion
       %Z.

ENTORNO

       DATEMSK
              Fichero que contiene patrones de formato.

       TZ, LC_TIME
              Variables usadas por strptime().

CONFORME A

       ISO 9899, POSIX 1003.1-2001

V'EASE TAMBI'EN

       localtime(3), strftime(3), strptime(3), time(3)

                               26 diciembre 2001                    GETDATE(3)