klocalizeddate.h

Go to the documentation of this file.

/*
    Copyright 2010 John Layt <john@layt.net>

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to
    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
    Boston, MA 02110-1301, USA.
*/

#ifndef KDATE_H
#define KDATE_H

#include <QtCore/QString>
#include <QtCore/QDate>

#include <kdecore_export.h>
#include "kcalendarsystem.h"
#include "klocale.h"

class KLocalizedDatePrivate;
class KDECORE_EXPORT KLocalizedDate
{
public:

    explicit KLocalizedDate(const QDate &date = QDate(), const KCalendarSystem *calendar = 0);

    KLocalizedDate(int year, int month, int day, const KCalendarSystem *calendar = 0);

    KLocalizedDate(const KLocalizedDate &rhs);

    KLocalizedDate &operator=(const KLocalizedDate &rhs);

    KLocalizedDate &operator=(const QDate &rhs);

    ~KLocalizedDate();

    void setCalendarSystem(KLocale::CalendarSystem calendarSystem);

    KLocale::CalendarSystem calendarSystem();

    const KCalendarSystem *calendar() const;

    bool isNull() const;

    bool isValid() const;

    bool setDate(const QDate &date);

    bool setDate(int year, int month, int day);

    bool setDate(int year, int dayOfYear);

    bool setDate(QString eraName, int yearInEra, int month, int day);

    bool setDate(KLocale::WeekNumberSystem weekNumberSystem, int year, int weekOfYear, int dayOfWeek);

    bool setCurrentDate();

    static KLocalizedDate currentDate();

    static KLocalizedDate fromDate(const QDate &date);

    static KLocalizedDate fromJulianDay(int jd);

    int toJulianDay() const;

    QDate date() const;

    void getDate(int *year, int *month, int *day) const;

    int year() const;

    int month() const;

    int day() const;

    QString eraName() const;

    QString eraYear() const;

    int yearInEra() const;

    int dayOfYear() const;

    int dayOfWeek() const;

    int week(int *yearNum = 0) const;

    int week(KLocale::WeekNumberSystem weekNumberSystem, int *yearNum = 0) const;

    int monthsInYear() const;

    int weeksInYear() const;

    int weeksInYear(KLocale::WeekNumberSystem weekNumberSystem) const;

    int daysInYear() const;

    int daysInMonth() const;

    int daysInWeek() const;

    bool isLeapYear() const;

    QString formatDate(KLocale::DateFormat dateFormat = KLocale::LongDate) const;

    QString formatDate(const QString &formatString,
                       KLocale::DateTimeFormatStandard formatStandard = KLocale::KdeFormat) const;

    QString formatDate(KLocale::DateTimeComponent component,
                       KLocale::DateTimeComponentFormat format = KLocale::DefaultComponentFormat,
                       KLocale::WeekNumberSystem weekNumberSystem = KLocale::DefaultWeekNumber) const;

    static KLocalizedDate readDate(const QString &dateString,
                                   KLocale::DateTimeParseMode parseMode = KLocale::LiberalParsing,
                                   const KCalendarSystem *calendar = 0);

    static KLocalizedDate readDate(const QString &dateString,
                                   KLocale::ReadDateFlags formatFlags,
                                   KLocale::DateTimeParseMode parseMode = KLocale::LiberalParsing,
                                   const KCalendarSystem *calendar = 0);

    static KLocalizedDate readDate(const QString &dateString,
                                   const QString &dateFormat,
                                   KLocale::DateTimeParseMode parseMode = KLocale::LiberalParsing,
                                   KLocale::DateTimeFormatStandard formatStandard = KLocale::KdeFormat,
                                   const KCalendarSystem *calendar = 0);

    KLocalizedDate addYears(int years) const;

    bool addYearsTo(int years);

    KLocalizedDate addMonths(int months) const;

    bool addMonthsTo(int months);

    KLocalizedDate addDays(int days) const;

    bool addDaysTo(int days);

    void dateDifference(const KLocalizedDate &toDate,
                        int *yearsDiff, int *monthsDiff, int *daysDiff, int *direction) const;

    void dateDifference(const QDate &toDate,
                        int *yearsDiff, int *monthsDiff, int *daysDiff, int *direction) const;

    int yearsDifference(const KLocalizedDate &toDate) const;

    int yearsDifference(const QDate &toDate) const;

    int monthsDifference(const KLocalizedDate &toDate) const;

    int monthsDifference(const QDate &toDate) const;

    int daysDifference(const KLocalizedDate &toDate) const;

    int daysDifference(const QDate &toDate) const;

    KLocalizedDate firstDayOfYear() const;

    KLocalizedDate lastDayOfYear() const;

    KLocalizedDate firstDayOfMonth() const;

    KLocalizedDate lastDayOfMonth() const;

    bool operator==(const KLocalizedDate &other) const;

    bool operator==(const QDate &other) const;

    bool operator!=(const KLocalizedDate &other) const;

    bool operator!=(const QDate &other) const;

    bool operator<(const KLocalizedDate &other) const;

    bool operator<(const QDate &other) const;

    bool operator<=(const KLocalizedDate &other) const;

    bool operator<=(const QDate &other) const;

    bool operator>(const KLocalizedDate &other) const;

    bool operator>(const QDate &other) const;

    bool operator>=(const KLocalizedDate &other) const;

    bool operator>=(const QDate &other) const;

private:

    friend QDataStream KDECORE_EXPORT &operator<<(QDataStream &out, const KLocalizedDate &date);
    friend QDataStream KDECORE_EXPORT &operator>>(QDataStream &in, KLocalizedDate &date);
    friend QDebug KDECORE_EXPORT operator<<(QDebug, const KLocalizedDate &);

    QSharedDataPointer<KLocalizedDatePrivate> d;
};

Q_DECLARE_METATYPE(KLocalizedDate)


QDataStream KDECORE_EXPORT &operator<<(QDataStream &out, const KLocalizedDate &date);

QDataStream KDECORE_EXPORT &operator>>(QDataStream &in, KLocalizedDate &date);

QDebug KDECORE_EXPORT operator<<(QDebug, const KLocalizedDate &);

#endif // KDATE_H