weekday — Return Sunday-first weekday numbers and optional English names.
weekday(D) returns double day numbers from 1 (Sunday) to 7 (Saturday). [number,name] = weekday(D) also returns abbreviated English day names as character rows. weekday(D,'long') requests full English names; 'short' is the default.
Syntax
DayNumber = weekday(D)
[DayNumber,DayName] = weekday(D,DayForm)Inputs
D- Type
Any- Required
- Yes
- Default
- —
- Description
- Datetime, serial date number, or supported date text.
DayForm- Type
StringScalar- Required
- No
- Default
short- Description
- 'short' or 'long' English day names; other locales are not implemented.
Returns
DayNumber- Type
NumericArray- Description
- Host double day number, Sunday = 1.
DayName- Type
Any- Description
- English short or long character rows.
Returned values from weekday depend on how many outputs the caller requests.
Day-name forms
The first output follows the input date array's shape. The optional second output has one character row per date, padded to its longest name. English short and long forms are supported; locale/language arguments and locale-dependent names are not yet implemented.
Numeric serial dates, datetime objects, and supported date text are accepted. A resident numeric input is gathered to the host; an invalid DayForm is rejected before provider access.
Execution and placement
The current date implementation evaluates these operations on the host. Resident numeric input is a RunMat extension and is rejected in MATLAB mode before provider access. In RunMat mode it is gathered through its provider owner; no date GPU kernel or fused operation is used. A provider gather can suspend or fail. The returned numeric, logical, or character value is host-resident.
These functions do not read files, access the network, call user callbacks, or mutate workspace state. The relative text values now, today, tomorrow, and yesterday read the local clock; datenum() also reads it. Results from those forms depend on the machine's local time setting.
Example
Number and English weekday name
n = datenum(2024,3,14); [d,name] = weekday(n);Using weekday with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how weekday changes the result.
Run a small weekday example, explain the result, then change one input and compare the output.
FAQ
Which day is 1?⌄
Sunday is 1 and Saturday is 7.
Related Datetime functions
Calendar Duration
caldays · calendarDuration · calendarDuration.eq · calendarDuration.minus · calendarDuration.ne · calendarDuration.plus · calmonths · calquarters · calweeks · calyears · datetick · iscalendarduration · isdatetime
Datetime
Construction
Operators
datetime.eq · datetime.ge · datetime.gt · datetime.le · datetime.lt · datetime.minus · datetime.ne · datetime.plus
Indexing
Duration
days · duration · duration.eq · duration.ge · duration.gt · duration.le · duration.lt · duration.minus · duration.ne · duration.plus · duration.subsasgn · duration.subsref · hours · isduration · milliseconds · minutes · seconds · years
Source you can read
Every RunMat function's source is public. Read exactly how weekday is executed, line by line, in Rust.
- View the source for weekday in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.