File Manager

X7ROOT File Manager

Current Path: /opt/alt/libicu65/usr/include/unicode

opt / alt / libicu65 / usr / include / unicode /

ðŸ“ ..
ðŸ“„ alphaindex.h(26.48 KB)
ðŸ“„ appendable.h(8.49 KB)
ðŸ“„ basictz.h(9.15 KB)
ðŸ“„ brkiter.h(27.8 KB)
ðŸ“„ bytestream.h(9.6 KB)
ðŸ“„ bytestrie.h(20.77 KB)
ðŸ“„ bytestriebuilder.h(7.08 KB)
ðŸ“„ calendar.h(105.74 KB)
ðŸ“„ caniter.h(7.43 KB)
ðŸ“„ casemap.h(25.33 KB)
ðŸ“„ char16ptr.h(7.22 KB)
ðŸ“„ chariter.h(24.05 KB)
ðŸ“„ choicfmt.h(23.91 KB)
ðŸ“„ coleitr.h(13.76 KB)
ðŸ“„ coll.h(56.23 KB)
ðŸ“„ compactdecimalformat.h(6.88 KB)
ðŸ“„ curramt.h(3.76 KB)
ðŸ“„ currpinf.h(7.3 KB)
ðŸ“„ currunit.h(4.05 KB)
ðŸ“„ datefmt.h(40.67 KB)
ðŸ“„ dbbi.h(1.19 KB)
ðŸ“„ dcfmtsym.h(20.13 KB)
ðŸ“„ decimfmt.h(87.38 KB)
ðŸ“„ docmain.h(6.97 KB)
ðŸ“„ dtfmtsym.h(37.7 KB)
ðŸ“„ dtintrv.h(3.84 KB)
ðŸ“„ dtitvfmt.h(46.63 KB)
ðŸ“„ dtitvinf.h(18.51 KB)
ðŸ“„ dtptngen.h(25.08 KB)
ðŸ“„ dtrule.h(8.68 KB)
ðŸ“„ edits.h(20.74 KB)
ðŸ“„ enumset.h(2.08 KB)
ðŸ“„ errorcode.h(4.84 KB)
ðŸ“„ fieldpos.h(8.69 KB)
ðŸ“„ filteredbrk.h(5.37 KB)
ðŸ“„ fmtable.h(24.42 KB)
ðŸ“„ format.h(12.5 KB)
ðŸ“„ formattedvalue.h(10.27 KB)
ðŸ“„ fpositer.h(3.04 KB)
ðŸ“„ gender.h(3.33 KB)
ðŸ“„ gregocal.h(31.71 KB)
ðŸ“„ icudataver.h(1.03 KB)
ðŸ“„ icuplug.h(11.88 KB)
ðŸ“„ idna.h(12.7 KB)
ðŸ“„ listformatter.h(9.47 KB)
ðŸ“„ localebuilder.h(11.27 KB)
ðŸ“„ localematcher.h(22.5 KB)
ðŸ“„ localpointer.h(19.69 KB)
ðŸ“„ locdspnm.h(7.12 KB)
ðŸ“„ locid.h(47.4 KB)
ðŸ“„ measfmt.h(11.33 KB)
ðŸ“„ measunit.h(93.31 KB)
ðŸ“„ measure.h(4.32 KB)
ðŸ“„ messagepattern.h(33.71 KB)
ðŸ“„ msgfmt.h(44.11 KB)
ðŸ“„ normalizer2.h(34.03 KB)
ðŸ“„ normlzr.h(30.94 KB)
ðŸ“„ nounit.h(2.69 KB)
ðŸ“„ numberformatter.h(86.31 KB)
ðŸ“„ numberrangeformatter.h(30.14 KB)
ðŸ“„ numfmt.h(49.81 KB)
ðŸ“„ numsys.h(7.19 KB)
ðŸ“„ parseerr.h(3.08 KB)
ðŸ“„ parsepos.h(5.56 KB)
ðŸ“„ platform.h(28.08 KB)
ðŸ“„ plurfmt.h(25.2 KB)
ðŸ“„ plurrule.h(18.39 KB)
ðŸ“„ ptypes.h(3.49 KB)
ðŸ“„ putil.h(6.33 KB)
ðŸ“„ rbbi.h(26.58 KB)
ðŸ“„ rbnf.h(48.73 KB)
ðŸ“„ rbtz.h(15.6 KB)
ðŸ“„ regex.h(84.36 KB)
ðŸ“„ region.h(9.18 KB)
ðŸ“„ reldatefmt.h(22.62 KB)
ðŸ“„ rep.h(9.37 KB)
ðŸ“„ resbund.h(18.07 KB)
ðŸ“„ schriter.h(6.32 KB)
ðŸ“„ scientificnumberformatter.h(6.4 KB)
ðŸ“„ search.h(22.22 KB)
ðŸ“„ selfmt.h(14.3 KB)
ðŸ“„ simpleformatter.h(12.59 KB)
ðŸ“„ simpletz.h(45.44 KB)
ðŸ“„ smpdtfmt.h(70.97 KB)
ðŸ“„ sortkey.h(11.18 KB)
ðŸ“„ std_string.h(1.05 KB)
ðŸ“„ strenum.h(9.92 KB)
ðŸ“„ stringoptions.h(5.79 KB)
ðŸ“„ stringpiece.h(7.38 KB)
ðŸ“„ stringtriebuilder.h(15.33 KB)
ðŸ“„ stsearch.h(21.3 KB)
ðŸ“„ symtable.h(4.27 KB)
ðŸ“„ tblcoll.h(36.61 KB)
ðŸ“„ timezone.h(41.02 KB)
ðŸ“„ tmunit.h(3.38 KB)
ðŸ“„ tmutamt.h(4.9 KB)
ðŸ“„ tmutfmt.h(7.85 KB)
ðŸ“„ translit.h(65.82 KB)
ðŸ“„ tzfmt.h(42.89 KB)
ðŸ“„ tznames.h(16.85 KB)
ðŸ“„ tzrule.h(35.37 KB)
ðŸ“„ tztrans.h(6.12 KB)
ðŸ“„ ubidi.h(89.56 KB)
ðŸ“„ ubiditransform.h(12.65 KB)
ðŸ“„ ubrk.h(23.97 KB)
ðŸ“„ ucal.h(56.9 KB)
ðŸ“„ ucasemap.h(15.18 KB)
ðŸ“„ ucat.h(5.36 KB)
ðŸ“„ uchar.h(140.56 KB)
ðŸ“„ ucharstrie.h(22.58 KB)
ðŸ“„ ucharstriebuilder.h(7.21 KB)
ðŸ“„ uchriter.h(13.2 KB)
ðŸ“„ uclean.h(11.21 KB)
ðŸ“„ ucnv.h(83.09 KB)
ðŸ“„ ucnv_cb.h(6.59 KB)
ðŸ“„ ucnv_err.h(20.99 KB)
ðŸ“„ ucnvsel.h(6.14 KB)
ðŸ“„ ucol.h(61.46 KB)
ðŸ“„ ucoleitr.h(9.46 KB)
ðŸ“„ uconfig.h(12.07 KB)
ðŸ“„ ucpmap.h(5.53 KB)
ðŸ“„ ucptrie.h(22.46 KB)
ðŸ“„ ucsdet.h(14.67 KB)
ðŸ“„ ucurr.h(16.12 KB)
ðŸ“„ udat.h(60.88 KB)
ðŸ“„ udata.h(15.56 KB)
ðŸ“„ udateintervalformat.h(10.03 KB)
ðŸ“„ udatpg.h(26.01 KB)
ðŸ“„ udisplaycontext.h(5.89 KB)
ðŸ“„ uenum.h(7.78 KB)
ðŸ“„ ufieldpositer.h(4.36 KB)
ðŸ“„ uformattable.h(10.94 KB)
ðŸ“„ uformattedvalue.h(12.14 KB)
ðŸ“„ ugender.h(2 KB)
ðŸ“„ uidna.h(33.37 KB)
ðŸ“„ uiter.h(22.77 KB)
ðŸ“„ uldnames.h(10.45 KB)
ðŸ“„ ulistformatter.h(8.83 KB)
ðŸ“„ uloc.h(52.54 KB)
ðŸ“„ ulocdata.h(11.26 KB)
ðŸ“„ umachine.h(14.53 KB)
ðŸ“„ umisc.h(1.33 KB)
ðŸ“„ umsg.h(24.23 KB)
ðŸ“„ umutablecptrie.h(8.24 KB)
ðŸ“„ unifilt.h(3.96 KB)
ðŸ“„ unifunct.h(4.04 KB)
ðŸ“„ unimatch.h(6.1 KB)
ðŸ“„ unirepl.h(3.38 KB)
ðŸ“„ uniset.h(64.9 KB)
ðŸ“„ unistr.h(170.43 KB)
ðŸ“„ unorm.h(20.52 KB)
ðŸ“„ unorm2.h(24.66 KB)
ðŸ“„ unum.h(53.62 KB)
ðŸ“„ unumberformatter.h(25.36 KB)
ðŸ“„ unumsys.h(7.21 KB)
ðŸ“„ uobject.h(10.68 KB)
ðŸ“„ upluralrules.h(7.88 KB)
ðŸ“„ uregex.h(72.05 KB)
ðŸ“„ uregion.h(9.84 KB)
ðŸ“„ ureldatefmt.h(17.26 KB)
ðŸ“„ urename.h(130.97 KB)
ðŸ“„ urep.h(5.38 KB)
ðŸ“„ ures.h(36.54 KB)
ðŸ“„ uscript.h(26.87 KB)
ðŸ“„ usearch.h(38.12 KB)
ðŸ“„ uset.h(40 KB)
ðŸ“„ usetiter.h(9.55 KB)
ðŸ“„ ushape.h(18 KB)
ðŸ“„ uspoof.h(65.9 KB)
ðŸ“„ usprep.h(8.14 KB)
ðŸ“„ ustdio.h(38.54 KB)
ðŸ“„ ustream.h(1.89 KB)
ðŸ“„ ustring.h(72.47 KB)
ðŸ“„ ustringtrie.h(3.15 KB)
ðŸ“„ utext.h(58.13 KB)
ðŸ“„ utf.h(7.86 KB)
ðŸ“„ utf16.h(23.32 KB)
ðŸ“„ utf32.h(763 B)
ðŸ“„ utf8.h(30.96 KB)
ðŸ“„ utf_old.h(45.83 KB)
ðŸ“„ utmscale.h(13.78 KB)
ðŸ“„ utrace.h(15.73 KB)
ðŸ“„ utrans.h(25.52 KB)
ðŸ“„ utypes.h(30.74 KB)
ðŸ“„ uvernum.h(6.67 KB)
ðŸ“„ uversion.h(6 KB)
ðŸ“„ vtzone.h(20.3 KB)

Editing: udateintervalformat.h

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
*****************************************************************************************
* Copyright (C) 2010-2012,2015 International Business Machines
* Corporation and others. All Rights Reserved.
*****************************************************************************************
*/

#ifndef UDATEINTERVALFORMAT_H
#define UDATEINTERVALFORMAT_H

#include "unicode/utypes.h"

#if !UCONFIG_NO_FORMATTING

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

/**
 * \file
 * \brief 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)
 * - The skeleton jm will produce
 *   for en_US, "7:56 AM - 7:56 PM"
 *   for en_GB, "7:56 - 19:56"
 * - The skeleton MMMd will produce
 *   for en_US, "Mar 4"
 *   for en_GB, "4 Mar"
 * If the range is 2010-03-04 07:56 - 2010-03-08 16:11 (4 days, 8 hours, 15 minutes)
 * - The skeleton jm will produce
 *   for en_US, "3/4/2010 7:56 AM - 3/8/2010 4:11 PM"
 *   for en_GB, "4/3/2010 7:56 - 8/3/2010 16:11"
 * - The skeleton MMMd will produce
 *   for en_US, "Mar 4-8"
 *   for en_GB, "4-8 Mar"
 * 
 * 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)
 */

/**
 * Opaque UDateIntervalFormat object for use in C programs.
 * @stable ICU 4.8
 */
struct UDateIntervalFormat;
typedef struct UDateIntervalFormat UDateIntervalFormat;  /**< C typedef for struct UDateIntervalFormat. @stable ICU 4.8 */

#ifndef U_HIDE_DRAFT_API
struct UFormattedDateInterval;
/**
 * Opaque struct to contain the results of a UDateIntervalFormat operation.
 * @draft ICU 64
 */
typedef struct UFormattedDateInterval UFormattedDateInterval;
#endif /* U_HIDE_DRAFT_API */

/**
 * Open a new UDateIntervalFormat object using the predefined rules for a
 * given locale plus a specified skeleton.
 * @param locale
 *            The locale for whose rules should be used; may be NULL for
 *            default locale.
 * @param skeleton
 *            A pattern containing only the fields desired for the interval
 *            format, for example "Hm", "yMMMd", or "yMMMEdHm".
 * @param skeletonLength
 *            The length of skeleton; may be -1 if the skeleton is zero-terminated.
 * @param tzID
 *            A timezone ID specifying the timezone to use. If 0, use the default
 *            timezone.
 * @param tzIDLength
 *            The length of tzID, or -1 if null-terminated. If 0, use the default
 *            timezone.
 * @param status
 *            A pointer to a UErrorCode to receive any errors.
 * @return
 *            A pointer to a UDateIntervalFormat object for the specified locale,
 *            or NULL if an error occurred.
 * @stable ICU 4.8
 */
U_STABLE UDateIntervalFormat* U_EXPORT2
udtitvfmt_open(const char*  locale,
              const UChar* skeleton,
              int32_t      skeletonLength,
              const UChar* tzID,
              int32_t      tzIDLength,
              UErrorCode*  status);

/**
 * Close a UDateIntervalFormat object. Once closed it may no longer be used.
 * @param formatter
 *            The UDateIntervalFormat object to close.
 * @stable ICU 4.8
 */
U_STABLE void U_EXPORT2
udtitvfmt_close(UDateIntervalFormat *formatter);

#ifndef U_HIDE_DRAFT_API
/**
 * Creates an object to hold the result of a UDateIntervalFormat
 * operation. The object can be used repeatedly; it is cleared whenever
 * passed to a format function.
 *
 * @param ec Set if an error occurs.
 * @return A pointer needing ownership.
 * @draft ICU 64
 */
U_CAPI UFormattedDateInterval* U_EXPORT2
udtitvfmt_openResult(UErrorCode* ec);

/**
 * Returns a representation of a UFormattedDateInterval as a UFormattedValue,
 * which can be subsequently passed to any API requiring that type.
 *
 * The returned object is owned by the UFormattedDateInterval and is valid
 * only as long as the UFormattedDateInterval is present and unchanged in memory.
 *
 * You can think of this method as a cast between types.
 *
 * When calling ufmtval_nextPosition():
 * The fields are returned from left to right. The special field category
 * UFIELD_CATEGORY_DATE_INTERVAL_SPAN is used to indicate which datetime
 * primitives came from which arguments: 0 means fromCalendar, and 1 means
 * toCalendar. The span category will always occur before the
 * corresponding fields in UFIELD_CATEGORY_DATE
 * in the ufmtval_nextPosition() iterator.
 *
 * @param uresult The object containing the formatted string.
 * @param ec Set if an error occurs.
 * @return A UFormattedValue owned by the input object.
 * @draft ICU 64
 */
U_CAPI const UFormattedValue* U_EXPORT2
udtitvfmt_resultAsValue(const UFormattedDateInterval* uresult, UErrorCode* ec);

/**
 * Releases the UFormattedDateInterval created by udtitvfmt_openResult().
 *
 * @param uresult The object to release.
 * @draft ICU 64
 */
U_CAPI void U_EXPORT2
udtitvfmt_closeResult(UFormattedDateInterval* uresult);
#endif /* U_HIDE_DRAFT_API */

#if U_SHOW_CPLUSPLUS_API

U_NAMESPACE_BEGIN

/**
 * \class LocalUDateIntervalFormatPointer
 * "Smart pointer" class, closes a UDateIntervalFormat via udtitvfmt_close().
 * For most methods see the LocalPointerBase base class.
 *
 * @see LocalPointerBase
 * @see LocalPointer
 * @stable ICU 4.8
 */
U_DEFINE_LOCAL_OPEN_POINTER(LocalUDateIntervalFormatPointer, UDateIntervalFormat, udtitvfmt_close);

#ifndef U_HIDE_DRAFT_API
/**
 * \class LocalUFormattedDateIntervalPointer
 * "Smart pointer" class, closes a UFormattedDateInterval via udtitvfmt_close().
 * For most methods see the LocalPointerBase base class.
 *
 * @see LocalPointerBase
 * @see LocalPointer
 * @draft ICU 64
 */
U_DEFINE_LOCAL_OPEN_POINTER(LocalUFormattedDateIntervalPointer, UFormattedDateInterval, udtitvfmt_closeResult);
#endif /* U_HIDE_DRAFT_API */

U_NAMESPACE_END

#endif

/**
 * Formats a date/time range using the conventions established for the
 * UDateIntervalFormat object.
 * @param formatter
 *            The UDateIntervalFormat object specifying the format conventions.
 * @param fromDate
 *            The starting point of the range.
 * @param toDate
 *            The ending point of the range.
 * @param result
 *            A pointer to a buffer to receive the formatted range.
 * @param resultCapacity
 *            The maximum size of result.
 * @param 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.
 *            There may be multiple instances of a given field type in an
 *            interval format; in this case the position indices refer to the
 *            first instance.
 * @param status
 *            A pointer to a UErrorCode to receive any errors.
 * @return
 *            The total buffer size needed; if greater than resultLength, the
 *            output was truncated.
 * @stable ICU 4.8
 */
U_STABLE int32_t U_EXPORT2
udtitvfmt_format(const UDateIntervalFormat* formatter,
                UDate           fromDate,
                UDate           toDate,
                UChar*          result,
                int32_t         resultCapacity,
                UFieldPosition* position,
                UErrorCode*     status);

#ifndef U_HIDE_DRAFT_API
/**
 * Formats a date/time range using the conventions established for the
 * UDateIntervalFormat object.
 * @param formatter
 *            The UDateIntervalFormat object specifying the format conventions.
 * @param result
 *            The UFormattedDateInterval to contain the result of the
 *            formatting operation.
 * @param fromDate
 *            The starting point of the range.
 * @param toDate
 *            The ending point of the range.
 * @param status
 *            A pointer to a UErrorCode to receive any errors.
 * @draft ICU 64
 */
U_DRAFT void U_EXPORT2
udtitvfmt_formatToResult(
                const UDateIntervalFormat* formatter,
                UFormattedDateInterval* result,
                UDate           fromDate,
                UDate           toDate,
                UErrorCode*     status);
#endif /* U_HIDE_DRAFT_API */

#endif /* #if !UCONFIG_NO_FORMATTING */

#endif

X7ROOT File Manager

Editing: udateintervalformat.h

Upload File

Create Folder