CalendarConvert[date,calendar]
converts the date object date to the specified calendar type calendar.
CalendarConvert[date]
converts to the default calendar type.
CalendarConvert[{date1,…,daten},calendar]
converts date1 through daten to the specified calendar.
CalendarConvert
CalendarConvert[date,calendar]
converts the date object date to the specified calendar type calendar.
CalendarConvert[date]
converts to the default calendar type.
CalendarConvert[{date1,…,daten},calendar]
converts date1 through daten to the specified calendar.
Details
- date specifications should be a DateObject expression.
- Date calendars can be given as named objects, like "Gregorian" or "Julian", or in the form {"name",<|param1val1,param2value2,…|>} for calendars with nondefault parameter values.
- Calendar parameters include:
-
"YearZero" whether the calendar includes a year zero "StartOfDay" beginning instant of the day "Location" reference geodetic position for astronomical calendars - Prominent arithmetic calendar types are: "Gregorian", "Julian", "Jewish" and "Islamic". Additional calendars are given by CalendarData["DateCalendar"].
Examples
open all close allBasic Examples (3)
Convert a date from the Icelandic calendar to its corresponding Gregorian calendar date:
CalendarConvert[DateObject[{2024, 270, 18, 5}, "Day", "Icelandic"]]Convert from the Gregorian to the Julian calendar:
CalendarConvert[DateObject[{2022, 1, 8}, "Day"], "Julian"]Convert from the Islamic to the Jewish calendar:
CalendarConvert[DateObject[{1435, 1, 29}, "Day", "Islamic"], "Jewish"]Convert multiple dates to a given calendar:
CalendarConvert[{DateObject[{2025, 2, 27}, "Day"], DateObject[{2025, 2, 28}, "Day"], DateObject[{2025, 3, 1}, "Day"]}, "Chinese"]Scope (4)
Convert a date to the default calendar type:
date = Entity["Person", "IsaacNewton::bhz5x"][EntityProperty["Person", "BirthDate"]]CalendarConvert[date]Explicitly convert to the Gregorian calendar:
CalendarConvert[date, "Gregorian"]Convert the beginning of the Julian date calendar to the Gregorian calendar:
DateObject[{0}, CalendarType -> "JulianDate", TimeZone -> 0]CalendarConvert[%, "Gregorian"]Compare to the result obtained using FromJulianDate directly:
FromJulianDate[0, TimeZone -> 0]Yom Kippur occurs on the 10th day of Tishrei (Ecclesiastical month 7) in the Jewish calendar:
DateObject[{5786, 7, 10}, "Day", "Jewish"]Give the corresponding date in the Gregorian calendar:
CalendarConvert[%]Convert a list of dates specified in different calendars to the Gregorian calendar:
people = Entity["PlaneCurve", "Catenary"][EntityProperty["PlaneCurve", "AssociatedPeople"]]dates = EntityValue[people, "BirthDate"]CalendarConvert[dates, "Gregorian"]Applications (2)
William Shakespeare died on April 23, 1616, in the Julian calendar:
date = Entity["Person", "WilliamShakespeare::s9r82"][EntityProperty["Person", "DeathDate"]]In the Gregorian calendar, that corresponds to May 3:
CalendarConvert[date, "Gregorian"]Julian date 0 corresponds to this instant in the proleptic Gregorian calendar:
FromJulianDate[0, TimeZone -> 0]It is January 1, -4713 noon GMT in the Julian calendar:
CalendarConvert[%, "Julian"]Properties & Relations (2)
DateObject[CalendarType->cal] is equivalent to CalendarConvert[DateObject[],cal]:
DateObject[CalendarType -> "Islamic"]CalendarConvert[DateObject[], "Islamic"]Dates between March 1, 200 and February 28, 300 coincide in the Gregorian and Julian calendars:
DateObject[{269, 4, 14}]CalendarConvert[%, "Julian"]Possible Issues (1)
For dates with coarse granularity, such as DateObject[{2022}], different calendars may not align completely:
CalendarConvert[DateObject[{2022, 1, 1}], "Jewish"]CalendarConvert[DateObject[{2022, 12, 31}], "Jewish"]In such cases, CalendarConvert will use the midpoint of the given date for conversion:
CalendarConvert[DateObject[{2022}], "Jewish"]CalendarConvert[DateObject[{2022, 7, 1}], "Jewish"]Related Guides
Text
Wolfram Research (2014), CalendarConvert, Wolfram Language function, https://reference.wolfram.com/language/ref/CalendarConvert.html (updated 2020).
CMS
Wolfram Language. 2014. "CalendarConvert." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/CalendarConvert.html.
APA
Wolfram Language. (2014). CalendarConvert. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/CalendarConvert.html
BibTeX
@misc{reference.wolfram_2026_calendarconvert, author="Wolfram Research", title="{CalendarConvert}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/CalendarConvert.html}", note=[Accessed: 12-June-2026]}
BibLaTeX
@online{reference.wolfram_2026_calendarconvert, organization={Wolfram Research}, title={CalendarConvert}, year={2020}, url={https://reference.wolfram.com/language/ref/CalendarConvert.html}, note=[Accessed: 12-June-2026]}