month — Extract month numbers from datetime values.

month extracts the calendar month from a datetime scalar or array and returns the result as doubles with the same shape as the input.

How month works

• month(t) accepts datetime scalars and datetime arrays.
• The output shape matches the input shape.
• Month values use the standard 1-through-12 numbering.
• Passing a non-datetime value raises a datetime-specific error.

How RunMat runs month on the GPU

month does not dispatch GPU kernels; it extracts the month component from CPU-side datetime objects.

GPU memory and residency

No. month reads datetime objects on the CPU and returns ordinary host-side numeric arrays.

Examples

Extract the month from a scalar datetime

t = datetime(2024, 4, 9, 13, 30, 0);
m = month(t)

Expected output:

m = 4

Extract months from a datetime array

t = datetime([2024 2025], [1 6], [15 20]);
m = month(t)

Expected output:

m =
     1     6

FAQ

Related Datetime functions

Open-source implementation

Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how month works, line by line, in Rust.

• View month.rs on GitHub
• Learn how the runtime works
• Found a bug? Open an issue with a minimal reproduction.

About RunMat

RunMat is an open-source runtime that executes MATLAB-syntax code — faster, on any GPU, with no license required.

• Simulations that took hours now take minutes. RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed.
• Start running code in seconds. Open the browser sandbox or download a single binary. No license server, no IT ticket, no setup.
• A full development environment. GPU-accelerated 2D and 3D plotting, automatic versioning on every save, and a browser IDE you can share with a link.

Getting started · Benchmarks · Pricing