Products
  • Wolfram|One

    The definitive Wolfram Language and notebook experience

  • Mathematica

    The original technical computing environment

  • Notebook Assistant + LLM Kit

    All-in-one AI assistance for your Wolfram experience

  • Compute Services
  • System Modeler
  • Finance Platform
  • Wolfram|Alpha Notebook Edition
  • Application Server
  • Enterprise Private Cloud
  • Wolfram Engine
  • Wolfram Player
  • Wolfram Cloud App
  • Wolfram Player App

More mobile apps

Core Technologies of Wolfram Products

  • Wolfram Language
  • Computable Data
  • Wolfram Notebooks
  • AI & Linguistic Understanding

Deployment Options

  • Wolfram Cloud
  • wolframscript
  • Wolfram Engine Community Edition
  • Wolfram LLM API
  • WSTPServer
  • Wolfram|Alpha APIs

From the Community

  • Function Repository
  • Community Paclet Repository
  • Example Repository
  • Neural Net Repository
  • Prompt Repository
  • Wolfram Demonstrations
  • Data Repository
  • Group & Organizational Licensing
  • All Products
Consulting & Solutions

We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

  • Data & Computational Intelligence
  • Model-Based Design
  • Algorithm Development
  • Wolfram|Alpha for Business
  • Blockchain Technology
  • Education Technology
  • Quantum Computation

Wolfram Consulting

Wolfram Solutions

  • Data Science
  • Artificial Intelligence
  • Biosciences
  • Healthcare Intelligence
  • Sustainable Energy
  • Control Systems
  • Enterprise Wolfram|Alpha
  • Blockchain Labs

More Wolfram Solutions

Wolfram Solutions For Education

  • Research Universities
  • Colleges & Teaching Universities
  • Junior & Community Colleges
  • High Schools
  • Educational Technology
  • Computer-Based Math

More Solutions for Education

  • Contact Us
Learning & Support

Get Started

  • Wolfram Language Introduction
  • Fast Intro for Programmers
  • Fast Intro for Math Students
  • Wolfram Language Documentation

More Learning

  • Highlighted Core Areas
  • Demonstrations
  • YouTube
  • Daily Study Groups
  • Wolfram Schools and Programs
  • Books

Grow Your Skills

  • Wolfram U

    Courses in computing, science, life and more

  • Community

    Learn, solve problems and share ideas.

  • Blog

    News, views and insights from Wolfram

  • Resources for

    Software Developers

Tech Support

  • Contact Us
  • Support FAQs
  • Support FAQs
  • Contact Us
Company
  • About Wolfram
  • Career Center
  • All Sites & Resources
  • Connect & Follow
  • Contact Us

Work with Us

  • Student Ambassador Initiative
  • Wolfram for Startups
  • Student Opportunities
  • Jobs Using Wolfram Language

Educational Programs for Adults

  • Summer School
  • Winter School

Educational Programs for Youth

  • Middle School Camp
  • High School Research Program
  • Computational Adventures

Read

  • Stephen Wolfram's Writings
  • Wolfram Blog
  • Wolfram Tech | Books
  • Wolfram Media
  • Complex Systems

Educational Resources

  • Wolfram MathWorld
  • Wolfram in STEM/STEAM
  • Wolfram Challenges
  • Wolfram Problem Generator

Wolfram Initiatives

  • Wolfram Science
  • Wolfram Foundation
  • History of Mathematics Project

Events

  • Stephen Wolfram Livestreams
  • Online & In-Person Events
  • Contact Us
  • Connect & Follow
Wolfram|Alpha
  • Your Account
  • User Portal
  • Wolfram Cloud
  • Products
    • Wolfram|One
    • Mathematica
    • Notebook Assistant + LLM Kit
    • Compute Services
    • System Modeler
    • Finance Platform
    • Wolfram|Alpha Notebook Edition
    • Application Server
    • Enterprise Private Cloud
    • Wolfram Engine
    • Wolfram Player
    • Wolfram Cloud App
    • Wolfram Player App

    More mobile apps

    • Core Technologies
      • Wolfram Language
      • Computable Data
      • Wolfram Notebooks
      • AI & Linguistic Understanding
    • Deployment Options
      • Wolfram Cloud
      • wolframscript
      • Wolfram Engine Community Edition
      • Wolfram LLM API
      • WSTPServer
      • Wolfram|Alpha APIs
    • From the Community
      • Function Repository
      • Community Paclet Repository
      • Example Repository
      • Neural Net Repository
      • Prompt Repository
      • Wolfram Demonstrations
      • Data Repository
    • Group & Organizational Licensing
    • All Products
  • Consulting & Solutions

    We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

    WolframConsulting.com

    Wolfram Solutions

    • Data Science
    • Artificial Intelligence
    • Biosciences
    • Healthcare Intelligence
    • Sustainable Energy
    • Control Systems
    • Enterprise Wolfram|Alpha
    • Blockchain Labs

    More Wolfram Solutions

    Wolfram Solutions For Education

    • Research Universities
    • Colleges & Teaching Universities
    • Junior & Community Colleges
    • High Schools
    • Educational Technology
    • Computer-Based Math

    More Solutions for Education

    • Contact Us
  • Learning & Support

    Get Started

    • Wolfram Language Introduction
    • Fast Intro for Programmers
    • Fast Intro for Math Students
    • Wolfram Language Documentation

    Grow Your Skills

    • Wolfram U

      Courses in computing, science, life and more

    • Community

      Learn, solve problems and share ideas.

    • Blog

      News, views and insights from Wolfram

    • Resources for

      Software Developers
    • Tech Support
      • Contact Us
      • Support FAQs
    • More Learning
      • Highlighted Core Areas
      • Demonstrations
      • YouTube
      • Daily Study Groups
      • Wolfram Schools and Programs
      • Books
    • Support FAQs
    • Contact Us
  • Company
    • About Wolfram
    • Career Center
    • All Sites & Resources
    • Connect & Follow
    • Contact Us

    Work with Us

    • Student Ambassador Initiative
    • Wolfram for Startups
    • Student Opportunities
    • Jobs Using Wolfram Language

    Educational Programs for Adults

    • Summer School
    • Winter School

    Educational Programs for Youth

    • Middle School Camp
    • High School Research Program
    • Computational Adventures

    Read

    • Stephen Wolfram's Writings
    • Wolfram Blog
    • Wolfram Tech | Books
    • Wolfram Media
    • Complex Systems
    • Educational Resources
      • Wolfram MathWorld
      • Wolfram in STEM/STEAM
      • Wolfram Challenges
      • Wolfram Problem Generator
    • Wolfram Initiatives
      • Wolfram Science
      • Wolfram Foundation
      • History of Mathematics Project
    • Events
      • Stephen Wolfram Livestreams
      • Online & In-Person Events
    • Contact Us
    • Connect & Follow
  • Wolfram|Alpha
  • Wolfram Cloud
  • Your Account
  • User Portal
Wolfram Language & System Documentation Center
DateValue
  • See Also
    • DateSelect
    • DateObject
    • DateString
    • DateList
    • DateBounds
    • DayName
    • TimeObject
    • CurrentDate
    • NextDate
    • PreviousDate
    • DateWithinQ
    • DateOverlapsQ
  • Related Guides
    • Date & Time
    • See Also
      • DateSelect
      • DateObject
      • DateString
      • DateList
      • DateBounds
      • DayName
      • TimeObject
      • CurrentDate
      • NextDate
      • PreviousDate
      • DateWithinQ
      • DateOverlapsQ
    • Related Guides
      • Date & Time

DateValue["elem"]

gives the specified element of the current date and time.

DateValue[{"elem1","elem2",…}]

gives a list of the specified elements of the current date and time.

DateValue[date,elem]

gives the specified element of the specified date.

DateValue[date,elem,form]

gives the result in the specified form.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Possible Issues  
See Also
Related Guides
Related Links
History
Cite this Page
BUILT-IN SYMBOL
  • See Also
    • DateSelect
    • DateObject
    • DateString
    • DateList
    • DateBounds
    • DayName
    • TimeObject
    • CurrentDate
    • NextDate
    • PreviousDate
    • DateWithinQ
    • DateOverlapsQ
  • Related Guides
    • Date & Time
    • See Also
      • DateSelect
      • DateObject
      • DateString
      • DateList
      • DateBounds
      • DayName
      • TimeObject
      • CurrentDate
      • NextDate
      • PreviousDate
      • DateWithinQ
      • DateOverlapsQ
    • Related Guides
      • Date & Time

DateValue

DateValue["elem"]

gives the specified element of the current date and time.

DateValue[{"elem1","elem2",…}]

gives a list of the specified elements of the current date and time.

DateValue[date,elem]

gives the specified element of the specified date.

DateValue[date,elem,form]

gives the result in the specified form.

Details

  • Elements related to year include the following:
  • "Year"Integerfull year (e.g. 2005)
    "YearShort"Integeryear (1- or 2-digits when a string)
    "YearUnsigned"Integeryear without a sign
    "YearExact"Realyear including fraction
    "YearFraction"Realfractional part of year
    "YearRomanNumeral"Stringyear using Roman numerals
    "ADBC"StringAD or BC
    "CEBCE"StringCE or BCE
  • Elements related to month include the following:
  • "Month"Integermonth number (2‐digits when a string)
    "MonthShort"Integermonth number (1‐ or 2‐digits when a string)
    "MonthExact"Realmonth including fraction
    "MonthFraction"Realfractional part of month
    "MonthName"Stringmonth name (e.g. "August")
    "MonthNameShort"Stringmonth name abbreviation (e.g. "Aug")
    "MonthNameInitial"Stringfirst letter of month name (e.g. "A")
    "MonthRomanNumeral"Stringmonth using Roman numerals
    "MonthRomanNumeralLowerCase"Stringmonth using lowercase Roman numerals
  • Elements related to day of the month include the following:
  • "Day"Integerday of the month (2‐digits when a string)
    "DayShort"Integerday of the month (1‐ or 2‐digits when a string)
    "DayExact"Realday including fraction
    "DayFraction"Realfractional part of day
  • Elements related to day of the week include the following:
  • "DayName"Symbolday of the week (e.g. Wednesday)
    "ISOWeekDay"Integerday number of week conforming to ISO-8601 (e.g. 3)
    "ISOWeekDayExact"Realday number of week including fraction
    "ISOWeekDayFraction"Realfractional day number of week
    "DayNameShort"Stringday of the week abbreviation (e.g. "Wed")
    "DayNameInitial"Stringfirst letter of day name (e.g. "W")
    "DayNameInstanceInMonth"Integerinstance number of day name within the month (e.g. 2)
  • Elements related to hour include the following:
  • "Hour"Integerhour (2‐digits when a string)
    "Hour12"Integerhour on 12‐hour clock (2‐digits when a string)
    "Hour24"Integerhour on 24‐hour clock (2‐digits when a string)
    "HourShort"Integerhour (1‐ or 2‐digits when a string)
    "Hour12Short"Integerhour on 12‐hour clock (1‐ or 2‐digits when a string)
    "Hour24Short"Integerhour on 24‐hour clock (1‐ or 2‐digits when a string)
    "HourExact"Realhour including fraction
    "HourFraction"Realfractional part of hour
    "AMPM"StringAM or PM
    "AMPMLowerCase"Stringam or pm
  • Elements related to minute include the following:
  • "Minute"Integerminutes (2‐digits when a string)
    "MinuteShort"Integerminutes (1‐ or 2‐digits when a string)
    "MinuteExact"Realminute including fraction
    "MinuteFraction"Realfractional part of minute
  • Elements related to second include the following:
  • "Second"Integerseconds (2-digits when a string)
    "SecondShort"Integerseconds (1‐ or 2‐digits when a string)
    "SecondExact"Realseconds including fractional seconds
    "SecondFraction"Realfractional part of seconds
  • Elements related to millisecond include the following:
  • "Millisecond"Integermilliseconds (3‐digits when a string)
    "MillisecondShort"Integermilliseconds (1‐, 2‐, or 3‐digit as a string)
    "MillisecondExact"Realmillisecond including fraction
    "MillisecondFraction"Realfractional part of millisecond
  • Elements larger than a year include the following:
  • "Millennium"Integer1000 year period beginning with year XX00
    "MillenniumBeginning01"Integer1000 year period beginning with year XX01
    "Century"Integer100 year period beginning with year XX00
    "CenturyBeginning01"Integer100 year period beginning with year XX01
    "Decade"Integer10 year period
  • Elements related quarters of a calendar year include:
  • "Quarter"Integerquarter number (e.g. 1)
    "QuarterName"Stringquarter of year (e.g. "Quarter 1")
    "QuarterNameShort"Stringquarter abbreviation (e.g. "Q1")
  • Elements related to ISO-8601 week numbers include:
  • "Week"Integerweek number (2‐digits when a string)
    "WeekShort"Integerweek number (1‐ or 2‐digits when a string)
    "WeekExact"Realweek number including fraction
    "WeekFraction"Realfractional week number
  • Additional ISO-8601 date elements include the following:
  • "ISOWeekYear"Integeryear number associated with ISO-8601 week date format
    "ISOYearDay"Integerday of year conforming to ISO-8601 (3-digits when a string)
    "ISOYearDayShort"Integerday of year (1-, 2-, or 3-digits when a string)
    "ISOYearDayExact"Realyear day including fraction
    "ISOYearDayFraction"Realfractional part of year day
  • Time zone elements include:
  • "TimeZone"Automatictime zone expression of reference date
    "TimeZoneName"Stringcommon name for the time zone (e.g. "Central Standard Time")
    "TimeZoneNameShort"Stringtime zone name abbreviation (e.g. "CST")
    "TimeZoneID"Stringinternet time zone name (e.g. "America/Chicago")
    "TimeZoneOffset"Realnumeric time zone offset from GMT
    "TimeZoneEntity"Entityentity expression representing the time zone
  • Additional date elements include:
  • "DayOfYear"Integerday number within the year
    "WeekBeginningSunday"Integerweek number of year indexed on Sunday
    "JulianDate"RealJulian day number (e.g. 2458275.25)
    "CalendarType"Stringcalendar type (e.g. "Gregorian")
    "Granularity"Stringcalendar granularity
    "AstrologicalSign"Stringastrological sign (e.g. "Aries")
  • Possible forms include:
  • Automaticnumbers, symbols, or strings, chosen automatically
    Integerclosest integer
    Realreal value
    Quantityvalue including units
    DateObjectcomplete date object
    TimeObjectcomplete time object
    Stringstring
    Entityentity object
  • In DateValue[date,elem,form], some form specifications may not be supported in all elements elem.
  • In DateValue[date,…], date can be specified as a DateObject or TimeObject, or results from DateList, DateString, or AbsoluteTime.
  • DateValue[date,spec,DateObject] can be used to give a DateObject that is granular only down to the level (e.g. day, month, year) specified by spec.
  • DateValue[GeoPosition[{lat,long,h,t}]] gives a DateObject of the time specified by t.
  • DateValue accepts a list of DateObject or TimeObject date specifications.

Examples

open all close all

Basic Examples  (1)

Get the current year:

Get multiple elements from the current date:

Get the month name from a given date:

Find the current "TimeZone" offset as a Quantity:

Scope  (4)

DateValue accepts all valid date and time specifications:

DateValue returns the time component of a GeoPosition argument:

DateValue also accepts a list of DateObject and TimeObject date specifications:

The ISO-8601 week begins on Monday and ends on Sunday:

Possible Issues  (2)

Some elements are not extractable for different inputs:

Not all types are valid for every element:

See Also

DateSelect  DateObject  DateString  DateList  DateBounds  DayName  TimeObject  CurrentDate  NextDate  PreviousDate  DateWithinQ  DateOverlapsQ

Related Guides

    ▪
  • Date & Time

Related Links

  • An Elementary Introduction to the Wolfram Language : Dates and Times

History

Introduced in 2014 (10.0) | Updated in 2015 (10.2) ▪ 2017 (11.1) ▪ 2018 (11.3)

Wolfram Research (2014), DateValue, Wolfram Language function, https://reference.wolfram.com/language/ref/DateValue.html (updated 2018).

Text

Wolfram Research (2014), DateValue, Wolfram Language function, https://reference.wolfram.com/language/ref/DateValue.html (updated 2018).

CMS

Wolfram Language. 2014. "DateValue." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2018. https://reference.wolfram.com/language/ref/DateValue.html.

APA

Wolfram Language. (2014). DateValue. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/DateValue.html

BibTeX

@misc{reference.wolfram_2025_datevalue, author="Wolfram Research", title="{DateValue}", year="2018", howpublished="\url{https://reference.wolfram.com/language/ref/DateValue.html}", note=[Accessed: 04-February-2026]}

BibLaTeX

@online{reference.wolfram_2025_datevalue, organization={Wolfram Research}, title={DateValue}, year={2018}, url={https://reference.wolfram.com/language/ref/DateValue.html}, note=[Accessed: 04-February-2026]}

Top
Introduction for Programmers
Introductory Book
Wolfram Function Repository | Wolfram Data Repository | Wolfram Data Drop | Wolfram Language Products
Top
  • Products
  • Wolfram|One
  • Mathematica
  • Notebook Assistant + LLM Kit
  • Compute Services
  • System Modeler

  • Wolfram|Alpha Notebook Edition
  • Wolfram|Alpha Pro
  • Mobile Apps

  • Wolfram Engine
  • Wolfram Player

  • Volume & Site Licensing
  • Server Deployment Options
  • Consulting
  • Wolfram Consulting
  • Repositories
  • Data Repository
  • Function Repository
  • Community Paclet Repository
  • Neural Net Repository
  • Prompt Repository

  • Wolfram Language Example Repository
  • Notebook Archive
  • Wolfram GitHub
  • Learning
  • Wolfram U
  • Wolfram Language Documentation
  • Webinars & Training
  • Educational Programs

  • Wolfram Language Introduction
  • Fast Introduction for Programmers
  • Fast Introduction for Math Students
  • Books

  • Wolfram Community
  • Wolfram Blog
  • Public Resources
  • Wolfram|Alpha
  • Wolfram Problem Generator
  • Wolfram Challenges

  • Computer-Based Math
  • Computational Thinking
  • Computational Adventures

  • Demonstrations Project
  • Wolfram Data Drop
  • MathWorld
  • Wolfram Science
  • Wolfram Media Publishing
  • Customer Resources
  • Store
  • Product Downloads
  • User Portal
  • Your Account
  • Organization Access

  • Support FAQ
  • Contact Support
  • Company
  • About Wolfram
  • Careers
  • Contact
  • Events
Wolfram Community Wolfram Blog
Legal & Privacy Policy
WolframAlpha.com | WolframCloud.com
© 2026 Wolfram
© 2026 Wolfram | Legal & Privacy Policy |
English