• Skip to content
  • Skip to link menu
KDE 3.5 API Reference
  • KDE API Reference
  • API Reference
  • Sitemap
  • Contact Us
 

KDECore

KCalendarSystemGregorian Class Reference

#include <kcalendarsystemgregorian.h>

Inheritance diagram for KCalendarSystemGregorian:

Inheritance graph
[legend]

List of all members.


Public Member Functions

virtual QDate addDays (const QDate &date, int ndays) const
virtual QDate addMonths (const QDate &date, int nmonths) const
virtual QDate addYears (const QDate &date, int nyears) const
virtual QString calendarName () const
virtual int day (const QDate &date) const
virtual int dayOfWeek (const QDate &date) const
virtual int dayOfYear (const QDate &date) const
virtual int daysInMonth (const QDate &date) const
virtual int daysInYear (const QDate &date) const
virtual bool isLunar () const
virtual bool isLunisolar () const
virtual bool isSolar () const
 KCalendarSystemGregorian (const KLocale *locale=0)
virtual int maxValidYear () const
virtual int minValidYear () const
virtual int month (const QDate &date) const
virtual QString monthName (const QDate &date, bool shortName=false) const
virtual QString monthName (int month, int year, bool shortName=false) const
virtual QString monthNamePossessive (const QDate &date, bool shortName=false) const
virtual QString monthNamePossessive (int month, int year, bool shortName=false) const
virtual int monthsInYear (const QDate &date) const
virtual bool setYMD (QDate &date, int y, int m, int d) const
virtual QString weekDayName (const QDate &date, bool shortName=false) const
virtual QString weekDayName (int weekDay, bool shortName=false) const
virtual int weekDayOfPray () const
virtual int weekNumber (const QDate &date, int *yearNum=0) const
virtual int weeksInYear (int year) const
virtual int year (const QDate &date) const
virtual int yearStringToInteger (const QString &sNum, int &iLength) const
virtual ~KCalendarSystemGregorian ()

Detailed Description

For internal use only.

This is the Gregorian calendar implementation.

The Gregorian calender is the most used calendar today. The first year in the calendar is set to the birth of Christ.

See also:
KLocale,KCalendarSystem,KCalendarSystemFactory
Author:
Carlos Moro <cfmoro@correo.uniovi.es>
Since:
3.2

Definition at line 43 of file kcalendarsystemgregorian.h.


Constructor & Destructor Documentation

KCalendarSystemGregorian::KCalendarSystemGregorian ( const KLocale *  locale = 0  ) 

Constructor.

Just like KCalendarSystem::KCalendarSystem().

Definition at line 32 of file kcalendarsystemgregorian.cpp.

KCalendarSystemGregorian::~KCalendarSystemGregorian (  )  [virtual]

Definition at line 37 of file kcalendarsystemgregorian.cpp.


Member Function Documentation

QDate KCalendarSystemGregorian::addDays ( const QDate &  date,
int  ndays 
) const [virtual]

Returns a QDate object containing a date ndays later.

Parameters:
date The old date
ndays The number of days to add
Returns:
The new date

Implements KCalendarSystem.

Definition at line 232 of file kcalendarsystemgregorian.cpp.

QDate KCalendarSystemGregorian::addMonths ( const QDate &  date,
int  nmonths 
) const [virtual]

Returns a QDate object containing a date nmonths later.

Parameters:
date The old date
nmonths The number of months to add
Returns:
The new date

Implements KCalendarSystem.

Definition at line 227 of file kcalendarsystemgregorian.cpp.

QDate KCalendarSystemGregorian::addYears ( const QDate &  date,
int  nyears 
) const [virtual]

Returns a QDate object containing a date nyears later.

Parameters:
date The old date
nyears The number of years to add
Returns:
The new date

Implements KCalendarSystem.

Definition at line 222 of file kcalendarsystemgregorian.cpp.

QString KCalendarSystemGregorian::calendarName (  )  const [virtual]

Gets the string representing the calendar.

Implements KCalendarSystem.

Definition at line 296 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::day ( const QDate &  date  )  const [virtual]

Gets specific calendar type day number of month for a given date.

Parameters:
date gregorian date equivalent to the specific one
Returns:
day of the month

Implements KCalendarSystem.

Definition at line 276 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::dayOfWeek ( const QDate &  date  )  const [virtual]

Gets specific calendar type number of day of week number for a given date.

Parameters:
date gregorian date
Returns:
day of week

Implements KCalendarSystem.

Definition at line 251 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::dayOfYear ( const QDate &  date  )  const [virtual]

Gets specific calendar type day number of year for a given date.

Parameters:
date gregorian date equivalent to the specific one
Returns:
day number

Implements KCalendarSystem.

Definition at line 256 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::daysInMonth ( const QDate &  date  )  const [virtual]

Gets specific calendar type number of days in month for a given date.

Parameters:
date gregorian date
Returns:
number of days for month in date

Implements KCalendarSystem.

Definition at line 261 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::daysInYear ( const QDate &  date  )  const [virtual]

Gets the number of days in date whose years specified.

Parameters:
date Gregorian date equivalent to the specific one
Returns:
The number of days in year

Implements KCalendarSystem.

Definition at line 286 of file kcalendarsystemgregorian.cpp.

bool KCalendarSystemGregorian::isLunar (  )  const [virtual]

Gets if the calendar is lunar based.

Returns:
if the calendar is lunar based

Implements KCalendarSystem.

Definition at line 301 of file kcalendarsystemgregorian.cpp.

bool KCalendarSystemGregorian::isLunisolar (  )  const [virtual]

Gets if the calendar is lunisolar based.

Returns:
if the calendar is lunisolar based

Implements KCalendarSystem.

Definition at line 306 of file kcalendarsystemgregorian.cpp.

bool KCalendarSystemGregorian::isSolar (  )  const [virtual]

Gets if the calendar is solar based.

Returns:
if the calendar is solar based

Implements KCalendarSystem.

Definition at line 311 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::maxValidYear (  )  const [virtual]

Gets the maximum year value supported by specific calendar type algorithms (QDate, 8000).

Returns:
maximum year supported

Implements KCalendarSystem.

Definition at line 271 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::minValidYear (  )  const [virtual]

Gets the first year value supported by specific calendar type algorithms.

Returns:
first year supported

Implements KCalendarSystem.

Definition at line 266 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::month ( const QDate &  date  )  const [virtual]

Gets specific calendar type month for a given gregorian date.

Parameters:
date gregorian date
Returns:
month number

Implements KCalendarSystem.

Definition at line 281 of file kcalendarsystemgregorian.cpp.

QString KCalendarSystemGregorian::monthName ( const QDate &  date,
bool  shortName = false 
) const [virtual]

Gets specific calendar type month name for a given gregorian date.

Parameters:
date Gregorian date
shortName Specifies if the short month name should be used
Returns:
The name of the month

Implements KCalendarSystem.

Definition at line 72 of file kcalendarsystemgregorian.cpp.

QString KCalendarSystemGregorian::monthName ( int  month,
int  year,
bool  shortName = false 
) const [virtual]

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

Parameters:
month The month number
year The year the month belongs to
shortName Specifies if the short month name should be used
Returns:
The name of the month

Implements KCalendarSystem.

Definition at line 83 of file kcalendarsystemgregorian.cpp.

QString KCalendarSystemGregorian::monthNamePossessive ( const QDate &  date,
bool  shortName = false 
) const [virtual]

Returns a string containing the possessive form of the month name.

("of January", "of February", etc.) It's needed in long format dates in some languages.

Parameters:
date Gregorian date
shortName Specifies if the short month name should be used
Returns:
The possessive form of the name of the month

Implements KCalendarSystem.

Definition at line 78 of file kcalendarsystemgregorian.cpp.

QString KCalendarSystemGregorian::monthNamePossessive ( int  month,
int  year,
bool  shortName = false 
) const [virtual]

Returns a string containing the possessive form of the month name.

("of January", "of February", etc.) It's needed in long format dates in some languages. If an invalid month is specified, QString::null is returned.

Parameters:
month The month number
year The year the month belongs to
shortName Specifies if the short month name should be used
Returns:
The possessive form of the name of the month

Implements KCalendarSystem.

Definition at line 147 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::monthsInYear ( const QDate &  date  )  const [virtual]

Gets specific calendar type number of month for a given year.

Parameters:
date The date whose year to use
Returns:
The number of months in that year

Implements KCalendarSystem.

Definition at line 46 of file kcalendarsystemgregorian.cpp.

bool KCalendarSystemGregorian::setYMD ( QDate &  date,
int  y,
int  m,
int  d 
) const [virtual]

Changes the date's year, month and day.

The range of the year, month and day depends on which calendar is being used.

Parameters:
date Date to change
y Year
m Month number
d Day of month
Returns:
true if the date is valid; otherwise returns false.

Implements KCalendarSystem.

Definition at line 212 of file kcalendarsystemgregorian.cpp.

QString KCalendarSystemGregorian::weekDayName ( const QDate &  date,
bool  shortName = false 
) const [virtual]

Gets specific calendar type week day name.

Parameters:
date the date
shortName short or complete day name
Returns:
day name

Implements KCalendarSystem.

Definition at line 245 of file kcalendarsystemgregorian.cpp.

QString KCalendarSystemGregorian::weekDayName ( int  weekDay,
bool  shortName = false 
) const [virtual]

Gets specific calendar type week day name If an invalid week day is specified, QString::null is returned.

Parameters:
weekDay number of day in week (1 -> Monday)
shortName short or complete day name
Returns:
day name

Implements KCalendarSystem.

Definition at line 237 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::weekDayOfPray (  )  const [virtual]

Gets the day of the week traditionaly associated with pray.

Returns:
day number

Implements KCalendarSystem.

Definition at line 291 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::weekNumber ( const QDate &  date,
int *  yearNum = 0 
) const [virtual]

Gets specific calendar type week number for a given date.

Parameters:
date gregorian date
yearNum The year the date belongs to
Returns:
week number

Implements KCalendarSystem.

Definition at line 66 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::weeksInYear ( int  year  )  const [virtual]

Gets the number of weeks in a specified year.

Parameters:
year the year
Returns:
number of weeks in year

Implements KCalendarSystem.

Definition at line 53 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::year ( const QDate &  date  )  const [virtual]

Gets specific calendar type year for a given gregorian date.

Parameters:
date gregorian date
Returns:
year

Implements KCalendarSystem.

Definition at line 41 of file kcalendarsystemgregorian.cpp.

int KCalendarSystemGregorian::yearStringToInteger ( const QString &  sNum,
int &  iLength 
) const [virtual]

Converts a year literal of a part of a string into a integer starting at the beginning of the string.

Parameters:
sNum The string to parse
iLength The number of QChars used, and 0 if no valid symbols was found in the string
Returns:
An integer corresponding to the year

Reimplemented from KCalendarSystem.

Definition at line 316 of file kcalendarsystemgregorian.cpp.


The documentation for this class was generated from the following files:
  • kcalendarsystemgregorian.h
  • kcalendarsystemgregorian.cpp

KDECore

Skip menu "KDECore"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

API Reference

Skip menu "API Reference"
  • dcop
  • DNSSD
  • interfaces
  • Kate
  • kconf_update
  • KDECore
  • KDED
  • kdefx
  • KDEsu
  • kdeui
  • KDocTools
  • KHTML
  • KImgIO
  • KInit
  • kio
  • kioslave
  • KJS
  • KNewStuff
  • KParts
  • KUtils
Generated for API Reference by doxygen 1.5.9
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal