getdate(3)                 Library Functions Manual                 getdate(3)

NUME
       getdate, getdate_r - converte<?>te un <?>ir de caractere care con<?>ine
       data <?>i ora intr-un format de timp defalcat

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <time.h>

       struct tm *getdate(const char *string);

       extern int getdate_err;

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

   Cerin<?>e pentru macrocomenzi de testare a caracteristicilor pentru glibc
   (consulta<?>i feature_test_macros(7)):

       getdate():
           _XOPEN_SOURCE >= 500

       getdate_r():
           _GNU_SOURCE

DESCRIERE
       Func<?>ia getdate()  converte<?>te o reprezentare sub forma de <?>ir a
       unei date <?>i ore, con<?>inuta in tamponul indicat de string, intr-o
       ora defalcata. Ora defalcata este stocata intr-o structura tm, iar un
       indicator catre aceasta structura este returnat ca rezultat al
       func<?>iei. Aceasta structura tm este alocata in memoria statica <?>i,
       in consecin<?>a, va fi suprascrisa de apeluri ulterioare catre
       getdate().

       Spre deosebire de strptime(3) (care are un argument format), getdate()
       utilizeaza formatele gasite in fi<?>ierul al carui nume complet este
       specificat in variabila de mediu DATEMSK. Prima linie din fi<?>ier care
       corespunde <?>irului de caractere introdus este utilizata pentru
       conversie.

       Potrivirea se face fara a <?>ine cont de majuscule <?>i minuscule.
       Spa<?>iile albe inutile, fie in model, fie in <?>irul care urmeaza sa
       fie convertit, sunt ignorate.

       Specifica<?>iile de conversie pe care le poate con<?>ine un model sunt
       cele date pentru strptime(3). O alta specifica<?>ie de conversie este
       specificata in POSIX.1-2001:

       %Z     Numele fusului orar. Acest lucru nu este implementat in glibc.

       Cand se specifica %Z, structura care con<?>ine ora defalcata este
       ini<?>ializata cu valori corespunzatoare orei curente in fusul orar
       specificat. In caz contrar, structura este ini<?>ializata cu ora
       defalcata corespunzatoare orei locale curente (ca urmare a apelului la
       localtime(3)).

       Cand se specifica doar ziua saptamanii, se considera ca ziua respectiva
       este prima zi de acest fel din ziua de azi sau din zilele urmatoare.

       Cand se specifica doar luna (<?>i nu anul), se considera ca luna este
       prima luna egala cu sau ulterioara lunii curente. Daca nu se specifica
       ziua, se considera ca este prima zi a lunii.

       Cand nu sunt specificate ora, minutul <?>i secunda, se iau ora, minutul
       <?>i secunda curente.

       Daca nu este specificata data, dar cunoa<?>tem ora, atunci acea ora
       este considerata prima ora egala sau ulterioara orei curente.

       getdate_r()  este o extensie GNU care ofera o versiune reentranta a
       getdate(). In loc sa utilizeze o variabila globala pentru a raporta
       erorile <?>i un tampon static pentru a returna timpul defalcat, aceasta
       returneaza erorile prin valoarea rezultatului func<?>iei <?>i
       returneaza timpul defalcat rezultat in tamponul alocat de apelant,
       indicat de argumentul res.

VALOAREA RETURNATA
       Cand are succes, getdate()  returneaza un indicator catre o structura
       struct tm.  In caz contrar, returneaza NULL <?>i define<?>te variabila
       globala getdate_err la unul dintre numerele de eroare prezentate mai
       jos.  Modificarile aduse errno sunt nespecificate.

       In caz de succes, getdate_r()  returneaza 0; in caz de eroare,
       returneaza unul dintre numerele de eroare prezentate mai jos.

ERORI-IE<?>IRE
       Urmatoarele erori sunt returnate prin getdate_err (pentru getdate())
       sau ca rezultat al func<?>iei (pentru getdate_r()):

       1   Variabila de mediu DATEMSK nu este definita sau valoarea sa este un
           <?>ir gol.

       2   Fi<?>ierul sablon specificat de DATEMSK nu poate fi deschis pentru
           citire.

       3   Nu s-au putut ob<?>ine informa<?>ii despre starea fi<?>ierului.

       4   Fi<?>ierul <?>ablon nu este un fi<?>ier obi<?>nuit.

       5   A aparut o eroare la citirea fi<?>ierului <?>ablon.

       6   Alocarea memoriei a e<?>uat (memorie insuficienta disponibila).

       7   Nu exista nicio linie in fi<?>ier care sa corespunda cu intrarea.

       8   Specifica<?>ie de intrare nevalida.

MEDIU
       DATEMSK
              Fi<?>ier care con<?>ine modele de format.

       TZ
       LC_TIME
              Variabilele utilizate de strptime(3).

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +------------+---------------------+-----------------------------------+
       |Interfa<?>a | Atribut             | Valoare                           |
       +------------+---------------------+-----------------------------------+
       |getdate()   | Siguran<?>a firelor | MT-Unsafe race:getdate env locale |
       +------------+---------------------+-----------------------------------+
       |getdate_r() | Siguran<?>a firelor | MT-Safe env locale                |
       +------------+---------------------+-----------------------------------+
VERSIUNI
       Specifica<?>ia POSIX.1 pentru strptime(3)  con<?>ine specifica<?>ii de
       conversie care utilizeaza modificatorul %E sau %O, in timp ce astfel de
       specifica<?>ii nu sunt furnizate pentru getdate().  In glibc, getdate()
       este implementata utilizand strptime(3), astfel incat ambele sa accepte
       exact acelea<?>i conversii.

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001.

EXEMPLE
       Programul de mai jos apeleaza getdate()  pentru fiecare dintre
       argumentele sale din linia de comanda <?>i, pentru fiecare apel,
       afi<?>eaza valorile din campurile structurii tm returnate.  Urmatoarea
       sesiune shell demonstreaza func<?>ionarea programului:

           $ TFILE=$PWD/tfile
           $ echo '%A' > $TFILE       # Numele complet al zilei saptamanii
           $ echo '%T' >> $TFILE      # Ora (HH:MM:SS)
           $ echo '%F' >> $TFILE      # Data ISO (AAAA-LL-ZZ)
           $ date
           $ export DATEMSK=$TFILE
           $ ./a.out Tuesday '2009-12-28' '12:22:33'
           Sun Sep  7 06:03:36 CEST 2008
           Call 1 ("Tuesday") succeeded:
               tm_sec   = 36
               tm_min   = 3
               tm_hour  = 6
               tm_mday  = 9
               tm_mon   = 8
               tm_year  = 108
               tm_wday  = 2
               tm_yday  = 252
               tm_isdst = 1
           Call 2 ("2009-12-28") succeeded:
               tm_sec   = 36
               tm_min   = 3
               tm_hour  = 6
               tm_mday  = 28
               tm_mon   = 11
               tm_year  = 109
               tm_wday  = 1
               tm_yday  = 361
               tm_isdst = 0
           Call 3 ("12:22:33") succeeded:
               tm_sec   = 33
               tm_min   = 22
               tm_hour  = 12
               tm_mday  = 7
               tm_mon   = 8
               tm_year  = 108
               tm_wday  = 0
               tm_yday  = 250
               tm_isdst = 1

   Sursa programului
       #define _GNU_SOURCE
       #include <stdio.h>
       #include <stdlib.h>
       #include <time.h>

       int
       main(int argc, char *argv[])
       {
           struct tm *tmp;

           for (size_t j = 1; j < argc; j++) {
               tmp = getdate(argv[j]);

               if (tmp == NULL) {
                   printf("Call %zu failed; getdate_err = %d\n",
                          j, getdate_err);
                   continue;
               }

               printf("Call %zu (\"%s\") succeeded:\n", j, argv[j]);
               printf("    tm_sec   = %d\n", tmp->tm_sec);
               printf("    tm_min   = %d\n", tmp->tm_min);
               printf("    tm_hour  = %d\n", tmp->tm_hour);
               printf("    tm_mday  = %d\n", tmp->tm_mday);
               printf("    tm_mon   = %d\n", tmp->tm_mon);
               printf("    tm_year  = %d\n", tmp->tm_year);
               printf("    tm_wday  = %d\n", tmp->tm_wday);
               printf("    tm_yday  = %d\n", tmp->tm_yday);
               printf("    tm_isdst = %d\n", tmp->tm_isdst);
           }

           exit(EXIT_SUCCESS);
       }

CONSULTA<?>I <?>I
       time(2), localtime(3), setlocale(3), strftime(3), strptime(3)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.15    17 mai 2025                       getdate(3)