Say Datetime

Since 1.2.0 AGI Commands Found this useful? Upvote it. ×

Says a given time as specified by the format given.

Last reviewed 2026-08-22

say datetime time escape_digits format timezone
Description

Say a given time, returning early if any of the given DTMFDual-Tone Multi-Frequency, the touch-tone signals phones send for digit input during a call, used by IVRs and feature codes. digits are received on the channelA single call leg passing through Asterisk. Channels represent connections to endpoints and are what dialplan applications act on.. Returns 0 if playback completes without a digit being pressed, or the ASCII numerical value of the digit if one was pressed or -1 on error/hangup.

Arguments
  • time required - Is number of seconds elapsed since 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC)
  • escape_digits required
  • format - Is the format the time should be said in. See voicemail.conf (defaults to ABdY 'digits/at' IMp).
  • timezone - Acceptable values can be found in /usr/share/zoneinfo Defaults to machine default.
User Notes

Know a tip or gotcha for this topic? Share it below and help others.

Contribute a note

Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.

Moderated before publishing. Email never shown.

Related

VERBOSE

Logs a message to the asterisk verbose log.

AGI Commands agi
NOOP

Does nothing.

AGI Commands agi
HANGUP

Hangs up the specified channel. If no channel name is given, hangs up the current channel. Asterisk AGI command referenc...

AGI Commands agi
GOSUB

Cause the channel to execute the specified dialplan subroutine.

AGI Commands agi
EXEC

Executes application with given options. Returns whatever the application returns, or '-2' on failure to find applicatio...

AGI Commands agi
AGI Commands
ANSWER ASYNCAGI BREAK CHANNEL STATUS CONTROL STREAM FILE DATABASE DEL DATABASE DELTREE DATABASE GET DATABASE PUT EXEC GET DATA GET FULL VARIABLE GET OPTION GET VARIABLE GOSUB HANGUP NOOP RECEIVE CHAR RECEIVE TEXT RECORD FILE SAY ALPHA SAY DATE SAY DATETIME SAY DIGITS SAY NUMBER SAY PHONETIC SAY TIME SEND IMAGE SEND TEXT SET AUTOHANGUP SET CALLERID SET CONTEXT SET EXTENSION SET MUSIC SET PRIORITY SET VARIABLE SPEECH ACTIVATE GRAMMAR SPEECH CREATE SPEECH DEACTIVATE GRAMMAR SPEECH DESTROY SPEECH LOAD GRAMMAR SPEECH RECOGNIZE SPEECH SET SPEECH UNLOAD GRAMMAR STREAM FILE TDD MODE VERBOSE WAIT FOR DIGIT