## Date and Time Formatting

Date and Time Formatting

## Synopsis

    enum                DTFormatKind;
    void                e_datetime_format_add_setup_widget  (GtkWidget *table,
                                                             gint row,
                                                             const gchar *component,
                                                             const gchar *part,
                                                             DTFormatKind kind,
                                                             const gchar *caption);
    gchar *             e_datetime_format_format            (const gchar *component,
                                                             const gchar *part,
                                                             DTFormatKind kind,
                                                             time_t value);
    gchar *             e_datetime_format_format_tm         (const gchar *component,
                                                             const gchar *part,
                                                             DTFormatKind kind,
                                                             struct tm *tm_time);
    gboolean            e_datetime_format_includes_day_name (const gchar *component,
                                                             const gchar *part,
                                                             DTFormatKind kind);

## Description

## Details

### enum DTFormatKind

    typedef enum {
    	DTFormatKindDate,
    	DTFormatKindTime,
    	DTFormatKindDateTime,
    	DTFormatKindShortDate
    } DTFormatKind;

### e_datetime_format_add_setup_widget ()

    void                e_datetime_format_add_setup_widget  (GtkWidget *table,
                                                             gint row,
                                                             const gchar *component,
                                                             const gchar *part,
                                                             DTFormatKind kind,
                                                             const gchar *caption);

Adds a setup widget for a component and part. The table should have 3 columns. All the work related to loading and saving the value is done automatically, on user's changes.

`table` : | Where to attach widgets. Requires 3 columns.
`row` : | On which row to attach.
`component` : | Component identifier for the format. Cannot be empty nor NULL.
`part` : | Part in the component, can be NULL or empty string.
`kind` : | Kind of the format for the component/part.
`caption` : | Caption for the widget, can be NULL, then the "Format:" is used.

### e_datetime_format_format ()

    gchar *             e_datetime_format_format            (const gchar *component,
                                                             const gchar *part,
                                                             DTFormatKind kind,
                                                             time_t value);

### e_datetime_format_format_tm ()

    gchar *             e_datetime_format_format_tm         (const gchar *component,
                                                             const gchar *part,
                                                             DTFormatKind kind,
                                                             struct tm *tm_time);

### e_datetime_format_includes_day_name ()

    gboolean            e_datetime_format_includes_day_name (const gchar *component,
                                                             const gchar *part,
                                                             DTFormatKind kind);