[Asterisk-Dev] PATCH: added SAY TIME to AGI Interface

[Tilghman Lesher]

On Sunday 14 September 2003 15:50, John Todd wrote:
> Here is my idea (modify as anyone sees fit):
>
> application: SayTime
>
> [Synopsis]:
>    Says the date given in the specified format and timezone
>
> [Description]
>    SayTime(time[|[format][|[zone][|options]]):  Takes the given time
> (UNIX seconds) and announces it in "long" form which is
> understandable to the listener, with optional formatting and timezone
> data.  Standard language localization is honored.
>
>     If no format is specified, the default format is "HABd".  For a
> short example of format options, see voicemail.conf.

Given that the default format in voicemailmain2 is "q", that should also
be the default format here.

>     Timezones are those used by strftime (examples: see
> /usr/share/zoneinfo).  Default timezone is whatever the system is set
> to use.

aka pass a NULL.

>     The "b" option treats the application as a "background"
> application, meaning that the user can press DTMF keys during
> playback and they will be interpreted as they are with the Background
> application.  Common usage would be for being able to "skip" over a
> date announcement with a keypress.

Actually, it should already be this way (I think).  Any DTMF should
interrupt the playback.

> Example:  SayTime(1063529070|IMp|US/Eastern)
>    would say: "Four forty-four PM"
>
> Example:  SayTime(1063529070)
>    would say (on a machine set to GMT): "Nineteen fourty-four,
> Saturday, September fourteenth"
>
> Example:  SayTime(1063529070||US/Eastern|b)
>    would say "Sixteen forty-four, Saturday, September fourteenth" but
> would allow the user to hit a digit to escape from the date readback

-Tilghman