GdaHandlerTime

## GdaHandlerTime GdaHandlerTime — Default handler for time, date and timestamp |

## Synopsis

                        GdaHandlerTime;
                        GdaHandlerTimeClass;
                        GdaHandlerTimePriv;
    GdaDataHandler *    gda_handler_time_new                (void);
    GdaDataHandler *    gda_handler_time_new_no_locale      (void);
    void                gda_handler_time_set_sql_spec       (GdaHandlerTime *dh,
                                                             GDateDMY first,
                                                             GDateDMY sec,
                                                             GDateDMY third,
                                                             gchar separator,
                                                             gboolean twodigits_years);
    gchar *             gda_handler_time_get_format         (GdaHandlerTime *dh,
                                                             GType type);

## Object Hierarchy

      GObject
       +----GdaHandlerTime

## Implemented Interfaces

GdaHandlerTime implements GdaDataHandler.

## Description

## Details

### GdaHandlerTime

    typedef struct _GdaHandlerTime GdaHandlerTime;

### GdaHandlerTimeClass

    typedef struct {
    	GObjectClass         parent_class;

    	/* Padding for future expansion */
    	void (*_gda_reserved1) (void);
    	void (*_gda_reserved2) (void);
    } GdaHandlerTimeClass;

### GdaHandlerTimePriv

    typedef struct _GdaHandlerTimePriv GdaHandlerTimePriv;

### gda_handler_time_new ()

    GdaDataHandler *    gda_handler_time_new                (void);

Creates a data handler for time values

Returns : | the new object

### gda_handler_time_new_no_locale ()

    GdaDataHandler *    gda_handler_time_new_no_locale      (void);

Creates a data handler for time values, but using the default C locale instead of the current user locale.

Returns : | the new object

### gda_handler_time_set_sql_spec ()

    void                gda_handler_time_set_sql_spec       (GdaHandlerTime *dh,
                                                             GDateDMY first,
                                                             GDateDMY sec,
                                                             GDateDMY third,
                                                             gchar separator,
                                                             gboolean twodigits_years);

Specifies the SQL output style of the `dh` data handler. The general format is "FIRSTsSECsTHIRD" where FIRST, SEC and THIRD are specified by `first`, `sec` and `trird` and 's' is the separator, specified by `separator`.

The default implementation is `first`=G_DATE_MONTH, `sec`=G_DATE_DAY and `third`=G_DATE_YEAR (the year is rendered on 4 digits) and the separator is '-'

`dh` : | a GdaHandlerTime object
`first` : | what comes first in the date representation
`sec` : | what comes second in the date representation
`third` : | what comes third in the date representation
`separator` : | separator character used between year, month and day
`twodigits_years` : | TRUE if year part of date must be rendered on 2 digits

### gda_handler_time_get_format ()

    gchar *             gda_handler_time_get_format         (GdaHandlerTime *dh,
                                                             GType type);

Get a string representing the locale-dependant way to enter a date/time/datetime, using a syntax suitable for the GnomeDbFormatEntry widget

`dh` : | a GdaHandlerTime object
`type` : | the type of data being handled
Returns : | a new string