udateintervalformat.h File Reference

C API: Format a date interval. More...

#include "unicode/utypes.h"
#include "unicode/umisc.h"
#include "unicode/localpointer.h"

Go to the source code of this file.

Typedefs

typedef struct UDateIntervalFormat UDateIntervalFormat
 C typedef for struct UDateIntervalFormat.

Functions

UDateIntervalFormatudtitvfmt_open (const char *locale, const UChar *skeleton, int32_t skeletonLength, const UChar *tzID, int32_t tzIDLength, UErrorCode *status)
 Open a new UDateIntervalFormat object using the predefined rules for a given locale plus a specified skeleton.
void udtitvfmt_close (UDateIntervalFormat *formatter)
 Close a UDateIntervalFormat object.
int32_t udtitvfmt_format (const UDateIntervalFormat *formatter, UDate fromDate, UDate toDate, UChar *result, int32_t resultCapacity, UFieldPosition *position, UErrorCode *status)
 Formats a date/time range using the conventions established for the UDateIntervalFormat object.

Detailed Description

C API: Format a date interval.

A UDateIntervalFormat is used to format the range between two UDate values in a locale-sensitive way, using a skeleton that specifies the precision and completeness of the information to show. If the range smaller than the resolution specified by the skeleton, a single date format will be produced. If the range is larger than the format specified by the skeleton, a locale-specific fallback will be used to format the items missing from the skeleton.

For example, if the range is 2010-03-04 07:56 - 2010-03-04 19:56 (12 hours)

Note: the "-" characters in the above sample output will actually be Unicode 2013, EN_DASH, in all but the last example.

Note, in ICU 4.4 the standard skeletons for which date interval format data is usually available are as follows; best results will be obtained by using skeletons from this set, or those formed by combining these standard skeletons (note that for these skeletons, the length of digit field such as d, y, or M vs MM is irrelevant (but for non-digit fields such as MMM vs MMMM it is relevant). Note that a skeleton involving h or H generally explicitly requests that time style (12- or 24-hour time respectively). For a skeleton that requests the locale's default time style (h or H), use 'j' instead of h or H. h, H, hm, Hm, hv, Hv, hmv, Hmv, d, M, MMM, MMMM, Md, MMMd, MEd, MMMEd, y, yM, yMMM, yMMMM, yMd, yMMMd, yMEd, yMMMEd

Locales for which ICU 4.4 seems to have a reasonable amount of this data include: af, am, ar, be, bg, bn, ca, cs, da, de (_AT), el, en (_AU,_CA,_GB,_IE,_IN...), eo, es (_AR,_CL,_CO,...,_US) et, fa, fi, fo, fr (_BE,_CH,_CA), fur, gsw, he, hr, hu, hy, is, it (_CH), ja, kk, km, ko, lt, lv, mk, ml, mt, nb, nl )_BE), nn, pl, pt (_PT), rm, ro, ru (_UA), sk, sl, so, sq, sr, sr_Latn, sv, th, to, tr, uk, ur, vi, zh (_SG), zh_Hant (_HK,_MO)

Definition in file udateintervalformat.h.


Typedef Documentation

C typedef for struct UDateIntervalFormat.

Stable:
ICU 4.8

Definition at line 80 of file udateintervalformat.h.


Function Documentation

void udtitvfmt_close ( UDateIntervalFormat formatter  ) 

Close a UDateIntervalFormat object.

Once closed it may no longer be used.

Parameters:
formatter The UDateIntervalFormat object to close.
Stable:
ICU 4.8
int32_t udtitvfmt_format ( const UDateIntervalFormat formatter,
UDate  fromDate,
UDate  toDate,
UChar result,
int32_t  resultCapacity,
UFieldPosition position,
UErrorCode status 
)

Formats a date/time range using the conventions established for the UDateIntervalFormat object.

Parameters:
formatter The UDateIntervalFormat object specifying the format conventions.
fromDate The starting point of the range.
toDate The ending point of the range.
result A pointer to a buffer to receive the formatted range.
resultCapacity The maximum size of result.
position A pointer to a UFieldPosition. On input, position->field is read. On output, position->beginIndex and position->endIndex indicate the beginning and ending indices of field number position->field, if such a field exists. This parameter may be NULL, in which case no field position data is returned.
status A pointer to a UErrorCode to receive any errors.
Returns:
The total buffer size needed; if greater than resultLength, the output was truncated.
Stable:
ICU 4.8
UDateIntervalFormat* udtitvfmt_open ( const char *  locale,
const UChar skeleton,
int32_t  skeletonLength,
const UChar tzID,
int32_t  tzIDLength,
UErrorCode status 
)

Open a new UDateIntervalFormat object using the predefined rules for a given locale plus a specified skeleton.

Parameters:
locale The locale for whose rules should be used; may be NULL for default locale.
skeleton A pattern containing only the fields desired for the interval format, for example "Hm", "yMMMd", or "yMMMEdHm".
skeletonLength The length of skeleton; may be -1 if the skeleton is zero-terminated.
tzID A timezone ID specifying the timezone to use. If 0, use the default timezone.
tzIDLength The length of tzID, or -1 if null-terminated. If 0, use the default timezone.
status A pointer to a UErrorCode to receive any errors.
Returns:
A pointer to a UDateIntervalFormat object for the specified locale, or NULL if an error occurred.
Stable:
ICU 4.8

Generated on 27 Mar 2014 for ICU 50.1.2 by  doxygen 1.6.1