basemax / calendarlibrary

The powerful library for display and convert calendar and handle the date units. (Soon)

CalendarLibrary

The powerful library for display and convert calendar and handle the date units.

This library will be release for C / C++.

Features

• Convert calendar units and dates.
• Display the current date.
• Convert date to string date, alphabet.
• Detecting the day of the date.

Abilities

• string display(dateDisplayType type)
• string format(string format)
• date convert(dateType target)

Example of the future:

date _date=Date(Date_Gregorian, 2019, 3, 4);
print( _date.format("Date is %y/%m/%d.\n") );

Predefined constants

Date Type

Constant	Description
DATE_GREGORIAN	Gregorian calendar
DATE_JALALI	Jalali calendar
DATE_LUNAR	Lunar calendar

Date Display Type

Constant	Description	Sample Output
DATE_ATOM	Atom	2013-04-12T15:52:01+00:00
DATE_COOKIE	HTTP Cookies	Friday, 12-Apr-13 15:52:01 UTC
DATE_RSS	RSS	Fri, 12 Aug 2013 15:52:01 +0000
DATE_ISO8601	ISO-8601	2013-04-12T15:52:01+0000
DATE_W3C	World Wide Web Consortium	2013-04-12T15:52:01+00:00
DATE_RFC822	RFC 822	Fri, 12 Apr 13 15:52:01 +0000
DATE_RFC850	RFC 850	Friday, 12-Apr-13 15:52:01 UTC
DATE_RFC1036	RFC 1036	Fri, 12 Apr 13 15:52:01 +0000
DATE_RFC1123	RFC 1123	Fri, 12 Apr 2013 15:52:01 +0000
DATE_RFC2822	RFC 2822	Fri, 12 Apr 2013 15:52:01 +0000
DATE_RFC3339	Same as DATE_ATOM	2013-04-12T15:52:01+00:00

Format Specifies

Constant	Description
%d	The day of the month (from 01 to 31)
%D	A textual representation of a day (three letters)
%j	The day of the month without leading zeros (1 to 31)
%l (lowercase 'L')	A full textual representation of a day
%N	The ISO-8601 numeric representation of a day (1 for Monday, 7 for Sunday)
%S	The English ordinal suffix for the day of the month (2 characters st, nd, rd or th. Works well with j)
%w	A numeric representation of the day (0 for Sunday, 6 for Saturday)
%z	The day of the year (from 0 through 365)
%W	The ISO-8601 week number of year (weeks starting on Monday)
%F	A full textual representation of a month (January through December)
%m	A numeric representation of a month (from 01 to 12)
%M	A short textual representation of a month (three letters)
%n	A numeric representation of a month, without leading zeros (1 to 12)
%t	The number of days in the given month
%L	Whether it's a leap year (1 if it is a leap year, 0 otherwise)
%o	The ISO-8601 year number
%Y	A four digit representation of a year
%y	A two digit representation of a year
%a	Lowercase am or pm
%A	Uppercase AM or PM
%B	Swatch Internet time (000 to 999)
%g	12-hour format of an hour (1 to 12)
%G	24-hour format of an hour (0 to 23)
%h	12-hour format of an hour (01 to 12)
%H	24-hour format of an hour (00 to 23)
%i	Minutes with leading zeros (00 to 59)
%s	Seconds, with leading zeros (00 to 59)
%u	Microseconds
%e	The timezone identifier (Examples: UTC, GMT, Atlantic/Azores)
%I (capital i)	Whether the date is in daylights savings time (1 if Daylight Savings Time, 0 otherwise)
%O	Difference to Greenwich time (GMT) in hours (Example: +0100)
%P	Difference to Greenwich time (GMT) in hours:minutes
%T	Timezone abbreviations (Examples: EST, MDT)
%Z	Timezone offset in seconds. The offset for timezones west of UTC is negative (-43200 to 50400)
%c	The ISO-8601 date (e.g. 2013-05-05T16:34:42+00:00)
%r	The RFC 2822 formatted date (e.g. Fri, 12 Apr 2013 12:01:05 +0200)
%U	The seconds since the Unix Epoch (January 1 1970 00:00:00 GMT)

Supported Calendar Systems

Name	Type	Group
Gregorian calendar
Jalali calendar	Solar	Iranian
Lunar calendar

View the full list at here.

Initial Start

According to Kambiz Asadzadeh, a CPP activist, there is a shortage of library for management and control over calendar and date, and the design of such a library can help a lot of developers in the world.

Given that I recently had a project for a company close to this, it was suggested to me to write such a library.

The developers are invited to develop this libraries in other languages such as Go, Rust, ...

License

CalendarLibrary is licensed under the GNU General Public License.