reldatefmt.h

Go to the documentation of this file.

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

#ifndef __RELDATEFMT_H
#define __RELDATEFMT_H

#include "unicode/utypes.h"
#include "unicode/uobject.h"
#include "unicode/udisplaycontext.h"
#include "unicode/ureldatefmt.h"
#include "unicode/locid.h"

#if !UCONFIG_NO_FORMATTING

typedef enum UDateRelativeUnit {

    UDAT_RELATIVE_SECONDS,

    UDAT_RELATIVE_MINUTES,

    UDAT_RELATIVE_HOURS,

    UDAT_RELATIVE_DAYS,

    UDAT_RELATIVE_WEEKS,

    UDAT_RELATIVE_MONTHS,

    UDAT_RELATIVE_YEARS,

#ifndef U_HIDE_DEPRECATED_API

    UDAT_RELATIVE_UNIT_COUNT
#endif  // U_HIDE_DEPRECATED_API
} UDateRelativeUnit;

typedef enum UDateAbsoluteUnit {

    // Days of week have to remain together and in order from Sunday to
    // Saturday.
    UDAT_ABSOLUTE_SUNDAY,

    UDAT_ABSOLUTE_MONDAY,

    UDAT_ABSOLUTE_TUESDAY,

    UDAT_ABSOLUTE_WEDNESDAY,

    UDAT_ABSOLUTE_THURSDAY,

    UDAT_ABSOLUTE_FRIDAY,

    UDAT_ABSOLUTE_SATURDAY,

    UDAT_ABSOLUTE_DAY,

    UDAT_ABSOLUTE_WEEK,

    UDAT_ABSOLUTE_MONTH,

    UDAT_ABSOLUTE_YEAR,

    UDAT_ABSOLUTE_NOW,

#ifndef U_HIDE_DRAFT_API

    UDAT_ABSOLUTE_QUARTER,
#endif // U_HIDE_DRAFT_API

#ifndef U_HIDE_DEPRECATED_API

    UDAT_ABSOLUTE_UNIT_COUNT = UDAT_ABSOLUTE_NOW + 2
#endif  // U_HIDE_DEPRECATED_API
} UDateAbsoluteUnit;

typedef enum UDateDirection {

    UDAT_DIRECTION_LAST_2,

    UDAT_DIRECTION_LAST,

    UDAT_DIRECTION_THIS,

    UDAT_DIRECTION_NEXT,

    UDAT_DIRECTION_NEXT_2,

    UDAT_DIRECTION_PLAIN,

#ifndef U_HIDE_DEPRECATED_API

    UDAT_DIRECTION_COUNT
#endif  // U_HIDE_DEPRECATED_API
} UDateDirection;

#if !UCONFIG_NO_BREAK_ITERATION

U_NAMESPACE_BEGIN

class BreakIterator;
class RelativeDateTimeCacheData;
class SharedNumberFormat;
class SharedPluralRules;
class SharedBreakIterator;
class NumberFormat;
class UnicodeString;

class U_I18N_API RelativeDateTimeFormatter : public UObject {
public:

    RelativeDateTimeFormatter(UErrorCode& status);

    RelativeDateTimeFormatter(const Locale& locale, UErrorCode& status);

    RelativeDateTimeFormatter(
        const Locale& locale, NumberFormat *nfToAdopt, UErrorCode& status);

    RelativeDateTimeFormatter(
            const Locale& locale,
            NumberFormat *nfToAdopt,
            UDateRelativeDateTimeFormatterStyle style,
            UDisplayContext capitalizationContext,
            UErrorCode& status);

    RelativeDateTimeFormatter(const RelativeDateTimeFormatter& other);

    RelativeDateTimeFormatter& operator=(
            const RelativeDateTimeFormatter& other);

    virtual ~RelativeDateTimeFormatter();

    UnicodeString& format(
            double quantity,
            UDateDirection direction,
            UDateRelativeUnit unit,
            UnicodeString& appendTo,
            UErrorCode& status) const;

    UnicodeString& format(
            UDateDirection direction,
            UDateAbsoluteUnit unit,
            UnicodeString& appendTo,
            UErrorCode& status) const;

    UnicodeString& formatNumeric(
            double offset,
            URelativeDateTimeUnit unit,
            UnicodeString& appendTo,
            UErrorCode& status) const;

    UnicodeString& format(
            double offset,
            URelativeDateTimeUnit unit,
            UnicodeString& appendTo,
            UErrorCode& status) const;

    UnicodeString& combineDateAndTime(
            const UnicodeString& relativeDateString,
            const UnicodeString& timeString,
            UnicodeString& appendTo,
            UErrorCode& status) const;

    const NumberFormat& getNumberFormat() const;

    UDisplayContext getCapitalizationContext() const;

    UDateRelativeDateTimeFormatterStyle getFormatStyle() const;

private:
    const RelativeDateTimeCacheData* fCache;
    const SharedNumberFormat *fNumberFormat;
    const SharedPluralRules *fPluralRules;
    UDateRelativeDateTimeFormatterStyle fStyle;
    UDisplayContext fContext;
    const SharedBreakIterator *fOptBreakIterator;
    Locale fLocale;
    void init(
            NumberFormat *nfToAdopt,
            BreakIterator *brkIter,
            UErrorCode &status);
    void adjustForContext(UnicodeString &) const;
};

U_NAMESPACE_END

#endif /* !UCONFIG_NO_BREAK_ITERATION */
#endif /* !UCONFIG_NO_FORMATTING */
#endif /* __RELDATEFMT_H */

---