Time handling

## Time handling Time handling — [DEPRECATED] Helper functions to convert between Epoch time and Mac (iPod) time |

## Synopsis

    time_t              itdb_time_get_mac_time              (void);
    time_t              itdb_time_mac_to_host               (time_t time);
    time_t              itdb_time_host_to_mac               (time_t time);

## Description

The functions provide conversion between Epoch time and Mac (iPod) time.

### Note

These functions are now obsolete and should no longer be used, libgpod automatically converts to/from Epoch time and iPod time when writing/reading the iPod databases.

## Details

### itdb_time_get_mac_time ()

    time_t              itdb_time_get_mac_time              (void);

### Warning

`itdb_time_get_mac_time` is deprecated and should not be used in newly-written code. kept for compatibility with older code, directly use `g_get_current_time()` or time(NULL) instead

Gets the current time in a format appropriate for storing in the libgpod data structures

Returns : | current time

### itdb_time_mac_to_host ()

    time_t              itdb_time_mac_to_host               (time_t time);

### Warning

`itdb_time_mac_to_host` is deprecated and should not be used in newly-written code. It's been kept for compatibility with older code, but this function is now a no-op

Converts a timestamp from libgpod format to host system timestamp.

`time` : | time expressed in libgpod format
Returns : | timestamp for the host system

### itdb_time_host_to_mac ()

    time_t              itdb_time_host_to_mac               (time_t time);

### Warning

`itdb_time_host_to_mac` is deprecated and should not be used in newly-written code. It's been kept for compatibility with older code, but this function is now a no-op

Convert host system timestamp to libgpod format timestamp

`time` : | time expressed in host unit
Returns : | a libgpod timestamp