UUID_TIME(3)                     Libuuid API                    UUID_TIME(3)

NAME         top

       uuid_time - extract the time at which the UUID was created

SYNOPSIS         top

       #include <uuid.h>

       time_t uuid_time(uuid_t uu, struct timeval *ret_tv)

DESCRIPTION         top

       The uuid_time function extracts the time at which the supplied time-
       based UUID uu was created.  Note that the UUID creation time is only
       encoded within certain types of UUIDs.  This function can only
       reasonably expect to extract the creation time for UUIDs created with
       the uuid_generate_time(3) and uuid_generate_time_safe(3) functions.
       It may or may not work with UUIDs created by other mechanisms.

RETURN VALUES         top

       The time at which the UUID was created, in seconds since January 1,
       1970 GMT (the epoch), is returned (see time(2)).  The time at which
       the UUID was created, in seconds and microseconds since the epoch, is
       also stored in the location pointed to by ret_tv (see

AUTHOR         top

       Theodore Y. Ts'o

AVAILABILITY         top

       libuuid is part of the util-linux package since version 2.15.1 and is
       available from

SEE ALSO         top

       uuid(3), uuid_clear(3), uuid_compare(3), uuid_copy(3),
       uuid_generate(3), uuid_is_null(3), uuid_parse(3), uuid_unparse(3)

COLOPHON         top

       This page is part of the util-linux (a random collection of Linux
       utilities) project.  Information about the project can be found at 
       ⟨⟩.  If you have a
       bug report for this manual page, send it to  This page was obtained from the
       project's upstream Git repository 
       ⟨git://⟩ on
       2017-03-13.  If you discover any rendering problems in this HTML ver‐
       sion of the page, or you believe there is a better or more up-to-date
       source for the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original man‐
       ual page), send a mail to

util-linux                        May 2009                      UUID_TIME(3)