GdaHanderTime

GdaHanderTime — Default handler for time values

Stability Level

Stable, unless otherwise indicated

Types and Values

Object Hierarchy

    GObject
    ╰── GdaHandlerTime

Implemented Interfaces

GdaHandlerTime implements GdaDataHandler.

Description

You should normally not need to use this API, refer to the GdaDataHandler interface documentation for more information.

Functions

gda_handler_time_new ()

GdaDataHandler *
gda_handler_time_new (void);

Creates a data handler for time values

Returns

the new object.

[type GdaHandlerTime][transfer full]


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.

[type GdaHandlerTime][transfer full]


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 '-'

Parameters

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_set_str_spec ()

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

Specifies the human readable 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 depends on the current locale, except if dh was created using gda_handler_time_new_no_locale().

Parameters

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

 

Since: 4.2.1


gda_handler_time_get_no_locale_str_from_value ()

gchar *
gda_handler_time_get_no_locale_str_from_value
                               (GdaHandlerTime *dh,
                                const GValue *value);

Parameters

dh

a GdaHandlerTime object

 

value

a GValue value

 

Returns

a new string representing value without taking the current locale into account (i.e. in the "C" locale)


gda_handler_time_get_format ()

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

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

Parameters

dh

a GdaHandlerTime object

 

type

the type of data being handled

 

Returns

a new string


gda_handler_time_get_hint ()

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

Get a string giving the user a hint about the locale-dependent requested format.

Parameters

dh

a GdaHandlerTime object

 

type

the type of data being handled

 

Returns

a new string

Since: 6.0

Types and Values

GDA_TYPE_HANDLER_TIME

#define GDA_TYPE_HANDLER_TIME (gda_handler_time_get_type())

GdaHandlerTime

typedef struct _GdaHandlerTime GdaHandlerTime;

See Also

GdaDataHandler interface