KCalendarSystemEthiopian Class Reference

#include <kcalendarsystemethiopian_p.h>

Inheritance diagram for KCalendarSystemEthiopian:

List of all members.

Public Member Functions
	KCalendarSystemEthiopian (const KLocale *locale=0)
	KCalendarSystemEthiopian (const KSharedConfig::Ptr config, const KLocale *locale=0)
virtual	~KCalendarSystemEthiopian ()
virtual QString	calendarType () const
virtual QDate	earliestValidDate () const
virtual QDate	epoch () const
virtual bool	isLeapYear (int year) const
virtual bool	isLeapYear (const QDate &date) const
virtual bool	isLunar () const
virtual bool	isLunisolar () const
virtual bool	isProleptic () const
virtual bool	isSolar () const
virtual bool	isValid (int year, int month, int day) const
virtual bool	isValid (const QDate &date) const
virtual QDate	latestValidDate () const
virtual QString	monthName (int month, int year, MonthNameFormat format=LongName) const
virtual QString	monthName (const QDate &date, MonthNameFormat format=LongName) const
virtual QString	weekDayName (int weekDay, WeekDayNameFormat format=LongDayName) const
virtual QString	weekDayName (const QDate &date, WeekDayNameFormat format=LongDayName) const
virtual int	weekDayOfPray () const
Protected Member Functions
	KCalendarSystemEthiopian (KCalendarSystemEthiopianPrivate &dd, const KSharedConfig::Ptr config=KSharedConfig::Ptr(), const KLocale *locale=0)
virtual bool	dateToJulianDay (int year, int month, int day, int &jd) const
virtual bool	julianDayToDate (int jd, int &year, int &month, int &day) const

---

Detailed Description

This is the Ethiopian calendar implementation which is the Coptic calendar but with a differenct Epoch and month/weekday names

license GNU-LGPL v.2 or later

See also:

KLocale,KCalendarSystem

Author:

John Layt <john@layt.net>

---

Constructor & Destructor Documentation

KCalendarSystemEthiopian::KCalendarSystemEthiopian

(

const KLocale *

locale = 0

)

[explicit]

Definition at line 295 of file kcalendarsystemethiopian.cpp.

KCalendarSystemEthiopian::KCalendarSystemEthiopian	(	const KSharedConfig::Ptr	config,
		const KLocale *	locale = 0
	)		[explicit]

Definition at line 301 of file kcalendarsystemethiopian.cpp.

KCalendarSystemEthiopian::~KCalendarSystemEthiopian

(

)

[virtual]

Definition at line 314 of file kcalendarsystemethiopian.cpp.

KCalendarSystemEthiopian::KCalendarSystemEthiopian	(	KCalendarSystemEthiopianPrivate &	dd,
		const KSharedConfig::Ptr	config = KSharedConfig::Ptr(),
		const KLocale *	locale = 0
	)		[protected]

Definition at line 307 of file kcalendarsystemethiopian.cpp.

---

Member Function Documentation

QString KCalendarSystemEthiopian::calendarType

(

)

const [virtual]

Deprecated:

use calendarSystem() instead

Returns the calendar system type.

Returns:

type of calendar system

Reimplemented from KCalendarSystemCoptic.

Definition at line 318 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::dateToJulianDay	(	int	year,
		int	month,
		int	day,
		int &	jd
	)		const [protected, virtual]

Internal method to convert YMD values for this calendar system into a Julian Day number.

All calendar system implementations MUST implement julianDayToDate and dateToJulianDay methods as all other methods can be expressed as functions of these. Does no internal validity checking.

See also:

KCalendarSystem::julianDayToDate

Parameters:

year	year number
month	month number
day	day of month
jd	Julian day number returned in this variable

Returns:

true if the date is valid, false otherwise

Reimplemented from KCalendarSystemCoptic.

Definition at line 415 of file kcalendarsystemethiopian.cpp.

QDate KCalendarSystemEthiopian::earliestValidDate

(

)

const [virtual]

Returns the earliest date valid in this calendar system implementation.

If the calendar system is proleptic then this may be before epoch.

See also:

KCalendarSystem::epoch

KCalendarSystem::latestValidDate

Returns:

date the earliest valid date

Reimplemented from KCalendarSystemCoptic.

Definition at line 330 of file kcalendarsystemethiopian.cpp.

QDate KCalendarSystemEthiopian::epoch

(

)

const [virtual]

Returns a QDate holding the epoch of the calendar system.

Usually YMD of 1/1/1, access the returned QDates method toJulianDay() if you require the actual Julian day number. Note: a particular calendar system implementation may not include the epoch in its supported range, or the calendar system may be proleptic in which case it supports dates before the epoch.

See also:

KCalendarSystem::earliestValidDate

KCalendarSystem::latestValidDate

KCalendarSystem::isProleptic

KCalendarSystem::isValid

Returns:

epoch of calendar system

Reimplemented from KCalendarSystemCoptic.

Definition at line 323 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::isLeapYear

(

int

year

)

const [virtual]

Returns whether a given year is a leap year.

Input year must be checked for validity in current Calendar System prior to calling, no validity checking performed in this routine, behaviour is undefined in invalid case.

Parameters:

year	the year to check

Returns:

true if the year is a leap year, false otherwise

Reimplemented from KCalendarSystemCoptic.

Definition at line 355 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::isLeapYear

(

const QDate &

date

)

const [virtual]

Returns whether a given date falls in a leap year.

Input date must be checked for validity in current Calendar System prior to calling, no validity checking performed in this routine, behaviour is undefined in invalid case.

Parameters:

date	the date to check

Returns:

true if the date falls in a leap year, false otherwise

Reimplemented from KCalendarSystemCoptic.

Definition at line 360 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::isLunar

(

)

const [virtual]

Returns whether the calendar is lunar based.

Returns:

true if the calendar is lunar based, false if not

Reimplemented from KCalendarSystemCoptic.

Definition at line 390 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::isLunisolar

(

)

const [virtual]

Returns whether the calendar is lunisolar based.

Returns:

true if the calendar is lunisolar based, false if not

Reimplemented from KCalendarSystemCoptic.

Definition at line 395 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::isProleptic

(

)

const [virtual]

Returns whether the calendar system is proleptic, i.e.

whether dates before the epoch are supported.

See also:

KCalendarSystem::epoch

Returns:

true if the calendar system is proleptic, false if not

Reimplemented from KCalendarSystemCoptic.

Definition at line 405 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::isSolar

(

)

const [virtual]

Returns whether the calendar is solar based.

Returns:

true if the calendar is solar based, false if not

Reimplemented from KCalendarSystemCoptic.

Definition at line 400 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::isValid	(	int	year,
		int	month,
		int	day
	)		const [virtual]

Returns whether a given date is valid in this calendar system.

Parameters:

year	the year portion of the date to check
month	the month portion of the date to check
day	the day portion of the date to check

Returns:

true if the date is valid, false otherwise

Reimplemented from KCalendarSystemCoptic.

Definition at line 345 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::isValid

(

const QDate &

date

)

const [virtual]

Returns whether a given date is valid in this calendar system.

Parameters:

date	the date to check

Returns:

true if the date is valid, false otherwise

Reimplemented from KCalendarSystemCoptic.

Definition at line 350 of file kcalendarsystemethiopian.cpp.

bool KCalendarSystemEthiopian::julianDayToDate	(	int	jd,
		int &	year,
		int &	month,
		int &	day
	)		const [protected, virtual]

Internal method to convert a Julian Day number into the YMD values for this calendar system.

All calendar system implementations MUST implement julianDayToDate and dateToJulianDay methods as all other methods can be expressed as functions of these. Does no internal validity checking.

See also:

KCalendarSystem::dateToJulianDay

Parameters:

jd	Julian day number to convert to date
year	year number returned in this variable
month	month number returned in this variable
day	day of month returned in this variable

Returns:

true if the date is valid, false otherwise

Reimplemented from KCalendarSystemCoptic.

Definition at line 410 of file kcalendarsystemethiopian.cpp.

QDate KCalendarSystemEthiopian::latestValidDate

(

)

const [virtual]

Returns the latest date valid in this calendar system implementation.

See also:

KCalendarSystem::epoch

KCalendarSystem::earliestValidDate

Returns:

date the latest valid date

Reimplemented from KCalendarSystemCoptic.

Definition at line 337 of file kcalendarsystemethiopian.cpp.

QString KCalendarSystemEthiopian::monthName	(	int	month,
		int	year,
		MonthNameFormat	format = LongName
	)		const [virtual]

Gets specific calendar type month name for a given month number If an invalid month is specified, QString() is returned.

Parameters:

month	the month number
year	the year the month belongs to
format	specifies whether the short month name or long month name should be used

Returns:

name of the month, empty string if any error

Reimplemented from KCalendarSystemCoptic.

Definition at line 365 of file kcalendarsystemethiopian.cpp.

QString KCalendarSystemEthiopian::monthName	(	const QDate &	date,
		MonthNameFormat	format = LongName
	)		const [virtual]

Gets specific calendar type month name for a given date.

Parameters:

date	date to obtain month from
format	specifies whether the short month name or long month name should be used

Returns:

name of the month, empty string if any error

Reimplemented from KCalendarSystemCoptic.

Definition at line 370 of file kcalendarsystemethiopian.cpp.

QString KCalendarSystemEthiopian::weekDayName	(	int	weekDay,
		WeekDayNameFormat	format = LongDayName
	)		const [virtual]

Gets specific calendar type week day name.

If an invalid week day is specified, QString() is returned.

Parameters:

weekDay	number of day in week (Monday = 1, ..., Sunday = 7)
format	specifies whether the short month name or long month name should be used

Returns:

day name, empty string if any error

Reimplemented from KCalendarSystemCoptic.

Definition at line 375 of file kcalendarsystemethiopian.cpp.

QString KCalendarSystemEthiopian::weekDayName	(	const QDate &	date,
		WeekDayNameFormat	format = LongDayName
	)		const [virtual]

Gets specific calendar type week day name.

Parameters:

date	the date
format	specifies whether the short month name or long month name should be used

Returns:

day name, empty string if any error

Reimplemented from KCalendarSystemCoptic.

Definition at line 380 of file kcalendarsystemethiopian.cpp.

int KCalendarSystemEthiopian::weekDayOfPray

(

)

const [virtual]

Deprecated:

use KLocale::weekDayOfPray() instead

Returns the day of the week traditionally associated with religious observance for this calendar system. Note this may not be accurate for the users locale, e.g. Gregorian calendar used in non-Christian countries, in use cases where this could be an issue it is recommended to use KLocale::weekDayOfPray() instead.

Returns:

day number (None = 0, Monday = 1, ..., Sunday = 7)

Reimplemented from KCalendarSystemCoptic.

Definition at line 385 of file kcalendarsystemethiopian.cpp.

---

The documentation for this class was generated from the following files:

• kcalendarsystemethiopian_p.h
• kcalendarsystemethiopian.cpp