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 */