PlayDate method

PlayDate is used to voice (speak) a date string to a caller. What this means is that your program does not need to have separate voice files for all the days of the week, months of the year, and numbers that are required to speak a date to a caller. ActiveAG provides this functionality for you.

PlayDate expects that the date string passed to it will be in the form: [m]m/[d]d/[yy]yy. That is, there will a month, a day, and a year in that order. Months and days may be either 1 or 2 characters. Years may be either 2 or 4 characters. (If a year is in 2-character form, it is assumed to be in the 20th century.) Finally, the parts of a date string may be separated by slashes (“/”) or dashes (“-“).

Examples: ActiveAG.PlayDate (“3/6/90”) ‘ Says “March sixth, nineteen ninety”

ActiveAG.PlayDate (Left(Now, 8)) ‘ Says the current date

PlayDate uses a set of voice files that are distributed with ActiveAG. These are known as the “prompt files” and there is a property, PromptVoiceFormat, that controls what encoding is used for these files.

Note: You may replace ActiveAG’s prompt files with ones that you have recorded yourself, or have had professionally recorded, if you like. If you do this, be certain that all prompt files use the same encoding rate.

Type

Arguments: DateString BSTR

Returns: A long integer status code (see ActiveAG Status codes)

Property interactions: This method is sensitive to the PromptVoiceFormat property.