SSML markup language guide

Description

Controls the pronunciation of the text within the tag. This is an optional tag. This tag is not supported for English text.

Syntax

 <phoneme alphabet="string" ph="string">text</phoneme>

Attributes

Tag relationships

The <phoneme> tag can contain text.

Example

 <speak>Go to the <phoneme alphabet="py" ph="dian3 dang4 hang2">pawnshop</phoneme> and <phoneme alphabet="py" ph="dang4 diao4">pawn</phoneme> this thing.</speak>

Audio effect: SSML-phoneme.mp3

Description

Inserts a prompt tone at any position during SSML synthesis.

Syntax

 <soundEvent src="URL"/>

Attributes

Tag relationships

The <soundEvent> tag is an empty tag and cannot contain any other tags.

Example

 <speak>A horse was startled<soundEvent src="http://nls.alicdn.com/sound-event/horse-neigh.wav"/>and people scattered to get away.</speak>

Audio effect: SSML-sound-event.mp3

Description

Specifies the information type of the enclosed text so that it is pronounced according to the default rules for that type.

Syntax

 <say-as interpret-as="string">text</say-as>

Attributes

Supported ranges for each <say-as> type

• cardinal

  Format	Example	Chinese output	Description
  Number string	145	145 (one hundred forty-five)	Integer input range: Positive or negative integers up to 20 digits, [-99999999999999999999, 99999999999999999999]. Decimal input range: No specific limit on the number of decimal places, but we recommend no more than 10.
  Negative sign + number string	-145	-145 (negative one hundred forty-five)
  3-digit number string with comma separator	10,000	10,000 (ten thousand)
  Negative sign + 3-digit number string with comma separator	-10,124	-10,124 (negative ten thousand one hundred twenty-four)
  Number string + decimal point + two zeros	10.00	10 (ten)
  Negative sign + number string + decimal point + two zeros	-110.00	-110 (negative one hundred ten)
  Number string + decimal point + number string	79.090	79.090 (seventy-nine point zero nine zero)
  Negative sign + number string + decimal point + number string	-79.001	-79.001 (negative seventy-nine point zero zero one)

  Format	Example	English output	Description
  Number string	145	one hundred forty five	Integer input range: Positive or negative integers up to 13 digits, [-999999999999, 999999999999]. Decimal input range: No specific limit on the number of decimal places, but we recommend no more than 10.
  Number string starting with zero	0145	one hundred forty five
  Negative sign + number string	-145	minus hundred forty five
  3-digit number string with comma separator	60,000	sixty thousand
  Negative sign + 3-digit number string with comma separator	-208,000	minus two hundred eight thousand
  Number string + decimal point + zero	12.00	twelve
  Number string + decimal point + number string	12.34	twelve point three four
  3-digit number string with comma separator + decimal point + number string	1,000.1	one thousand point one
  Negative sign + number string + decimal point + number string	-12.34	minus twelve point three four
  Negative sign + 3-digit number string with comma separator + decimal point + number string	-1,000.1	minus one thousand point one
  (3-digit with comma) number string + hyphen + (3-digit with comma) number	1-1,000	one to one thousand
  Other default pronunciations	012.34	twelve point three four	None
  	1/2	one half
  	-3/4	minus three quarters
  	5.1/6	five point one over six
  	-3 1/2	minus three and a half
  	1,000.3^3	one thousand point three to the power of three
  	3e9.1	three times ten to the power of nine point one
  	23.10%	twenty three point one percent

• digits

  Format	Example	Chinese output	Description
  Number string	129090909	129090909 (one two nine zero nine zero nine zero nine)	No specific limit on the length of the number string, but we recommend no more than 20 digits. When the number string exceeds 10 digits, a pause is inserted after each digit.

  Format	Example	English output	Description
  Number string	12034	one two zero three four	No specific limit on the length of the number string, but we recommend no more than 20 digits. When the number string is grouped by spaces or hyphens, a comma is inserted between groups to create a slight pause. A maximum of 5 groups is supported.
  Number string + space or hyphen + number string + space or hyphen + number string + space or hyphen + number string	1-23-456 7890	one, two three, four five six, seven eight nine zero

• telephone

  Format	Example	Chinese output	Description
  Landline number	4930286	493 0286 (four nine three, zero two eight six)	Supports 7- to 8-digit landline numbers. Supports spaces and "-" as separators. For 7-digit landline numbers, a "3-4" grouping is supported. For 8-digit landline numbers, a "4-4" grouping is supported.
  	493 0286	493 0286 (four nine three, zero two eight six)
  	493-0286	493 0286 (four nine three, zero two eight six)
  	62552560	6255 2560 (six two five five, two five six zero)
  	6255 2560	6255 2560 (six two five five, two five six zero)
  	6255-2560	6255 2560 (six two five five, two five six zero)
  Landline number + extension	4930286-109	493 0286 extension 109 (four nine three, zero two eight six, extension one zero nine)	Supports 1- to 4-digit extensions.
  	4930286 extension 109	493 0286 extension 109 (four nine three, zero two eight six, extension one zero nine)
  	4930286 extension 109	493 0286 extension 109 (four nine three, zero two eight six, extension one zero nine)
  	4930286 extension 109	493 0286 extension 109 (four nine three, zero two eight six, extension one zero nine)
  Area code + landline number	01062552560	010 6255 2560 (zero one zero, six two five five, two five six zero)	Supported area codes: 010, 02x, 03xx, 04xx, 05xx, 07xx, 08xx, 09xx.
  	010 62552560	010 6255 2560 (zero one zero, six two five five, two five six zero)
  	010 6255 2560	010 6255 2560 (zero one zero, six two five five, two five six zero)
  	010 6255-2560	010 6255 2560 (zero one zero, six two five five, two five six zero)
  	010-62552560	010 6255 2560 (zero one zero, six two five five, two five six zero)
  	010-6255-2560	010 6255 2560 (zero one zero, six two five five, two five six zero)
  	(010)62552560	010 6255 2560 (zero one zero, six two five five, two five six zero)
  	03198907098	0319 890 7098 (zero three one nine, eight nine zero, seven zero nine eight)
  	0319-8907098	319 890 7098 (three one nine, eight nine zero, seven zero nine eight)
  Area code + landline number + extension	010 62552560-109	010 6255 2560 extension 109 (zero one zero, six two five five, two five six zero, extension one zero nine)	None
  	010-62552560-109	010 6255 2560 extension 109 (zero one zero, six two five five, two five six zero, extension one zero nine)
  	(010)62552560-109	010 6255 2560 extension 109 (zero one zero, six two five five, two five six zero, extension one zero nine)
  	(010)62552560 extension 109	010 6255 2560 extension 109 (zero one zero, six two five five, two five six zero, extension one zero nine)
  	(010)62552560 extension 109	010 6255 2560 extension 109 (zero one zero, six two five five, two five six zero, extension one zero nine)
  	(010)62552560 extension 109	010 6255 2560 extension 109 (zero one zero, six two five five, two five six zero, extension one zero nine)
  Country code + area code + landline number	86-010-62791627	86 010 6279 1627 (eight six, zero one zero, six two seven nine, one six two seven)	Supported country codes: 86, (86), +86, (+86), 0086. All are pronounced as "eight six".
  	(86)10-62791627	86 10 6279 1627 (eight six, one zero, six two seven nine, one six two seven)
  	+86-010-62791627	86 010 6279 1627 (eight six, zero one zero, six two seven nine, one six two seven)
  	0086-10-62791627	86 10 6279 1627 (eight six, one zero, six two seven nine, one six two seven)
  	(+86)-10-6279 1627	86 10 6279 1627 (eight six, one zero, six two seven nine, one six two seven)
  Country code + area code + landline number + extension	(86)21-58118818-207	86 21 5811 8818 extension 207 (eight six, two one, five eight one one, eight eight one eight, extension two zero seven)	None
  	(86)021-5811-8818-207	86 021 5811 8818 extension 207 (eight six, zero two one, five eight one one, eight eight one eight, extension two zero seven)
  	(86)021-58118818 extension 207	86 021 5811 8818 extension 207 (eight six, zero two one, five eight one one, eight eight one eight, extension two zero seven)
  	(86)21-5811-8818 extension 207	86 21 5811 8818 extension 207 (eight six, two one, five eight one one, eight eight one eight, extension two zero seven)
  	+86-021-58118818 extension 207	86 021 5811 8818 extension 207 (eight six, zero two one, five eight one one, eight eight one eight, extension two zero seven)
  Mobile number	139 0000 5678	139 0000 5678 (one three nine, zero zero zero zero, five six seven eight)	Supports 11-digit mobile numbers. Supports 3-3-5 and 3-4-4 grouping formats.
  	139-000-05678	139 000 05678 (one three nine, zero zero zero, zero five six seven eight)
  	139 000 05678	139 000 05678 (one three nine, zero zero zero, zero five six seven eight)
  Country code + mobile number	+86-13900005678	86 139 0000 5678 (eight six, one three nine, zero zero zero zero, five six seven eight)	None
  	(+86)-139-0000-5678	86 139 0000 5678 (eight six, one three nine, zero zero zero zero, five six seven eight)
  	+8613900005678	86 139 0000 5678 (eight six, one three nine, zero zero zero zero, five six seven eight)
  	0086-139 000 05678	86 139 000 05678 (eight six, one three nine, zero zero zero, zero five six seven eight)
  Service number	123	123 (one two three)	Supports common service numbers. Supports 10-digit service numbers starting with 400/800, with a "3-3-4" grouping format. Supports 16-digit numbers starting with 12530/17951/12593.
  	95678	95678 (nine five six seven eight)
  	4008110510	400 811 0510 (four zero zero, eight one one, zero five one zero)
  	800-810-8888	800 810 8888 (eight zero zero, eight one zero, eight eight eight eight)
  	1253013520638377	12530 135 2063 8377 (one two five three zero, one three five, two zero six three, eight three seven seven)
  Other	(86)(21)9899-80800-0909	86 21 9899 80800 0909 (eight six, two one, nine eight nine nine, eight zero eight zero zero, zero nine zero nine)	Supports "number string + separator (parentheses, -)" format.

  Format	Example	English output	Description
  Number string	12034	one two oh three four	No specific limit on the length of the number string, but we recommend no more than 20 digits. When the number string is grouped by spaces or hyphens, a comma is inserted between groups to create a slight pause. A maximum of 5 groups is supported.
  Number string + space or hyphen + number string + space or hyphen + number string	1-23-456 7890	one, two three, four five six, seven eight nine oh
  Plus sign + number string + space or hyphen + number string	+43-211-0567	plus four three, two one one, oh five six seven
  Left parenthesis + number string + right parenthesis + space + number string + space or hyphen + number string	(21) 654-3210	(two one) six five four, three two one oh

• address

  Format	Example	Chinese output	Description
  Common address format	Yuanhe Town Jiayuan 30-9	Yuanhe Town Jiayuan thirty dash nine	Supports common address formats. In this context, an address refers to a standard mailing address.
  	Shitai Road No. 388 Lane 1107-1108	Shitai Road, Lane three eight eight, number one one zero seven dash one one zero eight
  	Huarun 24 City Phase 6 Jinyunfu 3-1-3205	Huarun 24 City Phase 6 Jinyunfu three dash one dash three two zero five
  	Shenghua Mingdu Building Block 2 Room 2006	Shenghua Mingdu Building, Block two, Room two zero zero six
  	Wuchang Street Courtyard Building 5 Unit 4 Room 201	Wuchang Street Courtyard, Building five, Unit four, two zero one
  	Furongjiang Road No. 150 Lane 19	Furongjiang Road, Lane one five zero, number nineteen

  This tag is not supported for English text.

• id

  Format	Example	Output	Description
  String	dell0101	D E L L zero one zero one	Supports uppercase and lowercase English letters, Arabic numerals 0-9, and underscores. The spaces in the output indicate a pause between each character, meaning the characters are read out one by one.
  	myid_1998	M Y I D underscore one nine nine eight
  	AiTest	A I T E S T

  For English text, this tag functions the same as the 'characters' tag.

• characters

  Format	Example	Chinese output	Description
  String	ISBN 1-001-099098-1	ISBN 1-001-099098-1	Supports Chinese characters, uppercase and lowercase English letters, Arabic numerals 0-9, and some full-width and half-width characters. The spaces in the output indicate a pause between each character, meaning the characters are read out one by one. If the text within the tag contains XML special characters, you must escape them.
  	x10b2345_u	x one zero b two three four five underscore u
  	v1.0.1	v1.0.1 (v one point zero point one)
  	version number 2.0	version number two point zero (version number two point zero)
  	SuM MA000	Su M M A zero zero zero (Su M M A zero zero zero)
  	Airbus A330	Airbus A three three zero (Airbus A three three zero)
  	models s01, s02, and s03	model s zero one s zero two and s zero three (model s zero one s zero two and s zero three)
  	Airbus A330	Airbus A330
  	αβγ	Alpha Beta Gamma

  Format	Example	English output	Description
  String	*b+3$.c-0'=α	asterisk B plus three dollar dot C dash zero apostrophe equals alpha	Supports Chinese characters, uppercase and lowercase English letters, Arabic numerals 0-9, and some full-width and half-width characters. The spaces in the output indicate a pause between each character, meaning the characters are read out one by one. If the text within the tag contains XML special characters, you must escape them.

• punctuation

  Format	Example	Chinese output	Description
  Punctuation	…	ellipsis (ellipsis)	Supports common Chinese and English punctuation. The spaces in the output indicate a pause between each character, meaning the characters are read out one by one. If the text within the tag contains XML special characters, you must escape them.
  	……	ellipsis
  	!"#$%&	Exclamation mark, double quotation marks, number sign, dollar sign, percent sign, and ampersand.
  	‘()*+	Single quote, Left parenthesis, Right parenthesis, Asterisk, and Plus sign.
  	,-./:;	Comma, dash, point, slash, colon, and semicolon.
  	<=>?@	Less than or equal to, greater than, question mark, and at sign
  	[\]^_	left bracket, backslash, right bracket, caret, underscore (left bracket, backslash, right bracket, caret, underscore)

  For English text, this tag functions the same as the 'characters' tag.

• date

  Format	Example	Spoken output	Description
  Year only (2 or 4 digits)	'71	Seventy-one	Supports 2-digit and 4-digit years. 2-digit years: 60–99, 00–09, and 10–19. 4-digit years: 1000–1999 and 2000–2099.
  	'04	Oh four
  	'19	Nineteen
  	1011	Ten eleven
  	1998	Nineteen ninety-eight
  	2008	Two thousand eight
  Year and month	April '98	April ninety-eight	For months 1 through 9, a leading zero is optional.
  	April 1998	April nineteen ninety-eight
  	August '08	August oh eight
  	August 2008	August two thousand eight
  Year, month, and day	April 23, '98	April twenty-third, ninety-eight	For days 1 through 9, a leading zero is optional.
  	April 23, 1998	April twenty-third, nineteen ninety-eight
  	August 8, '08	August eighth, oh eight
  	August 8, 2008	August eighth, two thousand eight
  Year, month, and day	April 23, '98	April twenty-third, ninety-eight	For days 1 through 9, a leading zero is optional.
  	April 23, 1998	April twenty-third, nineteen ninety-eight
  	August 8, '08	August eighth, oh eight
  	August 8, 2008	August eighth, two thousand eight
  Month and day	March 20	March twentieth	None
  	August 07	August seventh
  Abbreviated year and month	2018/08	August two thousand eighteen	Supports `/`, `-`, and `.` as separators.
  	2018-08	August two thousand eighteen
  	2018.08	August two thousand eighteen
  Abbreviated year, month, and day	2018/08/08	August eighth, two thousand eighteen
  	2018-8-8	August eighth, two thousand eighteen
  	2018.08.08	August eighth, two thousand eighteen
  Date range (full)	Sep 1-30, '04	September first to thirtieth, oh four	Supports `~` and `-` to represent a range.
  	Sep 1, 2004 - June 8, 2008	September first, two thousand four to June eighth, two thousand eight
  Date range (day only)	Sep 1-30, '04	September first to thirtieth, oh four
  	Sep 1, 2004 - June 8, 2008	September first, two thousand four to June eighth, two thousand eight
  Month range	April '01 - April '10	April oh one to April ten
  	April 2001 - April 2010	April two thousand one to April two thousand ten
  Day range (same year)	Oct 1 - Oct 7	October first to October seventh
  	Oct 01 - Oct 07	October first to October seventh
  Day range (same month)	Oct 1-7	October first to the seventh
  	Oct 01-07	October first to the seventh
  Abbreviated date range	2018/03/03~2019/01/01	March third, two thousand eighteen to January first, two thousand nineteen	Supports `/` and `.` as separators. Supports `~` and `-` to represent a range.
  	1997.9.9~1998.9.9	September ninth, nineteen ninety-seven to September ninth, nineteen ninety-eight
  Abbreviated month-day range	10/20~10/31	October twentieth to October thirty-first
  Month range (abbreviated)	1-10 month	January to October
  	Jan-Oct	January to October
  Abbreviated month, day, year	10/20/2018	October twentieth, two thousand eighteen	Only 4-digit years are supported. The `/` character must be used as the separator. The date must be in `month/day/year` format.

  Format	Example	English output	Description
  YYYY/YY or YYYY-YY	2000/01	two thousand, oh one	Span of years.
  	1900-01	nineteen hundred, oh one
  	2001-02	twenty oh one, oh two
  	2019-20	twenty nineteen, twenty
  	1998-99	nineteen ninety eight, ninety nine
  	1999-00	nineteen ninety nine, oh oh
  Four-digit number starting with 1 or 2	2000	two thousand	Four-digit year.
  	1900	nineteen hundred
  	1905	nineteen oh five
  	2021	twenty twenty one
  day-day or Day of the week range or Day of the Week	mon-wed	monday to wednesday	For a range of days. If the text within the tag contains XML special characters, you must escape them.
  	tue~fri	tuesday to friday
  	sat&sun	saturday and sunday
  DD-DD MMM, YYYY or DD~DD MMM, YYYY or DD&DD MMM, YYYY	19-20 Jan, 2000	the nineteen to the twentieth of january two thousand	DD is a two-digit day, MMM is the three-letter abbreviation or full word for the month, and YYYY is a four-digit year starting with 1 or 2.
  	01 ~ 10 Jul, 2020	the first to the tenth of july twenty twenty
  	05&06 Apr, 2009	the fifth and the sixth of april two thousand nine
  MMM DD-DD or MMM DD~DD or MMM DD&DD	Feb 01 - 03	feburary the first to the third	MMM is the three-letter abbreviation or full word for the month, and DD is a two-digit day.
  	Aug 10~20	august the tenth to the twentieth
  	Dec 11&12	december the eleventh and the twelfth
  MMM-MMM or MMM~MMM or MMM&MMM	Jan-Jun	january to june	MMM is the three-letter abbreviation or full word for the month.
  	jul ~ dec	july to december
  	sep&oct	september and october
  YYYY-YYYY or YYYY~YYYY	1990 - 2000	nineteen ninety to two thousand	YYYY is a four-digit year starting with 1 or 2.
  	2001~2021	two thousand one to twenty twenty one
  WWW DD MMM YYYY	Sun 20 Nov 2011	sunday the twentieth of november twenty eleven	WWW is the three-letter abbreviation or full word for the day of the week, DD is a two-digit day, MMM is the three-letter abbreviation or full word for the month, MM is a two-digit month (or three-letter abbreviation or full word), and YYYY is a four-digit year starting with 1 or 2.
  WWW DD MMM	Sun 20 Nov	sunday the twentieth of november
  WWW MMM DD YYYY	Sun Nov 20 2011	sunday november the twentieth twenty eleven
  WWW MMM DD	Sun Nov 20	sunday november the twentieth
  WWW YYYY-MM-DD	Sat 2010-10-01	aturday october the first twenty ten
  WWW YYYY/MM/DD	Sat 2010/10/01	saturday october the first twenty ten
  WWW MM/DD/YYYY	Sun 11/20/2011	sunday november the twentieth twenty eleven
  MM/DD/YYYY	11/20/2011	november the twentieth twenty eleven
  YYYY	1998	nineteen ninety eight
  Other default pronunciations	10 Mar, 2001	the tenth of march two thousand one	None
  	10 Mar	the tenth of march
  	Mar 2001	march two thousand one
  	Fri. 10/Mar/2001	friday the tenth of march two thousand one
  	Mar 10th, 2001	march the tenth two thousand one
  	Mar 10	march the tenth
  	2001/03/10	march the tenth two thousand one
  	2001-03-10	march the tenth two thousand one
  	2000s	two thousands
  	2010's	twenty tens
  	1900's	nineteen hundreds
  	1990s	nineteen nineties

• time

  Format	Example	Chinese output	Description
  Time of day	12:00	twelve o'clock (twelve o'clock)	Supports common time and time range formats.
  	12:00:00	twelve o'clock (twelve o'clock)
  	10:20	ten twenty (ten twenty)
  	10:20:30	ten twenty and thirty seconds (ten twenty and thirty seconds)
  	09:18:14	nine eighteen and fourteen seconds (nine eighteen and fourteen seconds)
  time ~ time	11:00~12:00	eleven to twelve (eleven to twelve)
  	09:00-14:00	nine to fourteen (nine to fourteen)
  	11:00~11:30	eleven to eleven thirty (eleven to eleven thirty)
  	11:00-12:18	eleven to twelve eighteen (eleven to twelve eighteen)
  	10:30~11:00	ten thirty to eleven (ten thirty to eleven)
  	09:28-10:00	nine twenty-eight to ten (nine twenty-eight to ten)
  	10:20~11:20	ten twenty to eleven twenty (ten twenty to eleven twenty)
  	06:00~08:00	six to eight (six to eight)
  	10:20 AM–1:30 PM	10:20–13:30
  Time abbreviation	5:00 am	five o'clock in the morning (five o'clock in the morning)
  	5:30 am	five thirty in the morning (five thirty in the morning)
  	5:20:12 am	five twenty and twelve seconds in the morning (five twenty and twelve seconds in the morning)
  	7:00 am	seven o'clock in the morning (seven o'clock in the morning)
  	7:30 AM	seven thirty AM (seven thirty AM)
  	7:20:12 a.m.	seven twenty and twelve seconds a.m. (seven twenty and twelve seconds a.m.)
  	07:08:12 A.M.	seven oh eight and twelve seconds A.M. (seven oh eight and twelve seconds A.M.)
  	5:00 pm	five o'clock in the afternoon (five o'clock in the afternoon)
  	5:30 PM	five thirty PM (five thirty PM)
  	5:20:12 p.m.	five twenty and twelve seconds p.m. (five twenty and twelve seconds p.m.)
  	05:09:12 P.M.	five oh nine and twelve seconds P.M. (five oh nine and twelve seconds P.M.)
  	9:00 pm	nine o'clock at night (nine o'clock at night)
  	9:30 pm	nine thirty at night (nine thirty at night)
  	9:20:12 PM	nine twenty and twelve seconds PM (nine twenty and twelve seconds PM)
  	9:02:12 P.M.	9:02:12 p.m.
  	12:00 pm	twelve o'clock noon (twelve o'clock noon)
  	12:30 p.m.	12:30 PM
  	12:20:12 PM	twelve twenty and twelve seconds PM (twelve twenty and twelve seconds PM)

  Format	Example	English output	Description
  HH:MM AM or PM	09:00 AM	nine A M	HH is a one- or two-digit hour, MM is a two-digit minute, and AM/PM indicates morning/afternoon.
  	09:03 PM	nine oh three P M
  	09:13 p.m.	nine thirteen p m
  HH:MM	21:00	twenty one hundred
  HHMM	100	one oclock
  time-time	8:00 am - 05:30 pm	eight a m to five p m	Supports common time formats and ranges.
  	7:05~10:15 AM	seven oh five to ten fifteen A M
  	09:00-13:00	nine oclock to thirteen hundred

• currency

  Format	Example	Chinese output	Description
  Number + currency identifier	12.00 CNY	twelve CNY (twelve CNY)	Supports AUD (Australian dollar), CAD (Canadian dollar), HKD (Hong Kong dollar), JPY (Japanese yen), USD (US dollar), CHF (Swiss franc), NOK (Norwegian krone), SEK (Swedish krona), GBP (British pound), CNY (Renminbi), CNY (yuan), and EUR (euro). Supported number formats include integers, decimals, and international format with comma separators.
  	12.50 CNY	twelve point five zero CNY (twelve point five zero CNY)
  	12,000,000 CNY	CNY 12 million
  	12,000,000.00 CNY	twelve million CNY (twelve million CNY)
  	12,000.35 CNY	Twelve thousand yuan and thirty-five fen
  Currency identifier + number	$12	twelve dollars (twelve dollars)	Supports CAD (Canadian dollar), $ (dollar), Fr (franc), kr (Danish krone), £ (pound), ¥ (yuan), and € (euro). Supported number formats include integers, decimals, and international format with comma separators.
  	$12.00	twelve dollars (twelve dollars)
  	$12.12	two point one two dollars (two point one two dollars)
  	$12,000	twelve thousand dollars (twelve thousand dollars)
  	$12,000.00	12,000 USD
  	$12,000.99	twelve thousand point nine nine dollars (twelve thousand point nine nine dollars)
  Other default readings	1213	One thousand two hundred thirteen	None
  	1213 KML	One thousand two hundred thirteen K M L
  	1213.00 KML	1213 K M L
  	1213.9 KML	one thousand two hundred thirteen point nine KML (one thousand two hundred thirteen point nine K M L)
  	1,000 KML	One thousand Keyhole Markup Language (KML)
  	1,000.00 KML	1,000 KML
  	1,000.98 KML	one thousand point nine eight KML (one thousand point nine eight K M L)
  	12,000	12,000

  Format	Example	English output	Description
  Number + currency identifier	1.00 CNY	one yuan	Supported number formats: integers, decimals, and international format with comma separators. Supported currency identifiers: CN¥ (yuan) CNY (yuan) CNY (yuan) AUD (australian dollar) CAD (canadian dollar) CHF (swiss franc) DKK (danish krone) EUR (euro) GBP (british pound) HKD (Hong Kong(China) dollar) JPY (japanese yen) NOK (norwegian krone) SEK (swedish krona) SGD (singapore dollar) USD (united states dollar)
  	2.02 CNY	two point zero two yuan
  	1,000.23 CN¥	one thousand point two three yuan
  	1.01 SGD	one singapore dollar and one cent
  	2.01 CAD	two canadian dollars and one cent
  	3.1 HKD	three hong kong dollars and ten cents
  	1,000.00 EUR	one thousand euros
  Currency identifier + number	US$ 1.00	one US dollar	Supported number formats: integers, decimals, and international format with comma separators. Supported currency identifiers: US$ (US dollar) CA$ (Canadian dollar) AU$ (Australian dollar) SG$ (Singapore dollar) HK$ (Hong Kong dollar) C$ (Canadian dollar) A$ (Australian dollar) $ (dollar) £ (pound) € (euro) CN¥ (yuan) CNY (yuan) CNY (yuan) AUD (australian dollar) CAD (canadian dollar) CHF (swiss franc) DKK (danish krone) EUR (euro) GBP (british pound) HKD (Hong Kong(China) dollar) JPY (japanese yen) NOK (norwegian krone) SEK (swedish krona) SGD (singapore dollar) USD (united states dollar)
  	$0.01	one cent
  	JPY 1.01	one japanese yen and one sen
  	£1.1	one pound and ten pence
  	€2.01	two euros and one cent
  	USD 1,000	one thousand united states dollars
  Number + quantifier + currency identifier or Currency identifier + number + quantifier	1.23 Tn CNY	one point two three trillion yuan	Supported quantifier formats include the following: thousand million billion trillion Mil (million) mil (million) Bil (billion) bil (billion) MM (million) Bn (billion) bn (billion) Tn (trillion) tn (trillion) K(thousand) k (thousand) M (million) m (million)
  	$1.2 K	one point two thousand dollars

• measure

  Format	Example	Chinese output	Description
  Number + Chinese unit	2 pieces	two pieces (two pieces)	Supports common Chinese units and their abbreviations.
  	120 hectares	one hundred twenty hectares (one hundred twenty hectares)
  	over 100 milligrams	over one hundred milligrams (over one hundred milligrams)
  	about 100 meters	about one hundred meters (about one hundred meters)
  	over 100 people	over one hundred people (over one hundred people)
  	1 cm 20 mm	one centimeter twenty millimeters (one centimeter twenty millimeters)
  	120.00 square kilometers	one hundred twenty square kilometers (one hundred twenty square kilometers)
  Number + unit abbreviation	120.56 cm²	120.56 square centimeters
  	120 ㎡ 56 cm²	one hundred twenty square meters fifty-six square centimeters (one hundred twenty square meters fifty-six square centimeters)
  	100 m 12 cm 6 mm	one hundred meters twelve centimeters six millimeters (one hundred meters twelve centimeters six millimeters)
  Range	10~15 kg	ten to fifteen kilograms (ten to fifteen kilograms)
  	10.24–789.82 mu	ten point two four to seven hundred eighty-nine point eight two mu (ten point two four to seven hundred eighty-nine point eight two mu)
  	10–15 meters	ten to fifteen meters (ten to fifteen meters)
  	10.24 cm~19.08 cm	ten point two four to nineteen point zero eight centimeters (ten point two four to nineteen point zero eight centimeters)
  Number + unit "/" + unit	10 yuan per jin	ten yuan per jin (ten yuan per jin)
  	199–299 yuan per item	one hundred ninety-nine to two hundred ninety-nine yuan per item (one hundred ninety-nine to two hundred ninety-nine yuan per item)
  	299.99–399.99 yuan per gram	two hundred ninety-nine point nine nine to three hundred ninety-nine point nine nine yuan per gram (two hundred ninety-nine point nine nine to three hundred ninety-nine point nine nine yuan per gram)
  Other default pronunciations	12 bundles	twelve bundles (twelve bundles)
  	30 rm	30 RPM
  	400 million compatriots	four hundred million compatriots (four hundred million compatriots)
  	12.897 micrograms	twelve point eight nine seven micrograms (twelve point eight nine seven micrograms)

  Format	Example	English output	Description
  Number + measurement unit	1.0 kg	one kilogram	Supported number formats: integers, decimals, and international format with comma separators. Supports common unit abbreviations.
  	1,234.01 km	one thousand two hundred thirty four point zero one kilometres.
  Measurement unit	mm2	square millimetre

• The following table lists the pronunciations of common symbols for the <say-as> tag.

  Symbol	Chinese pronunciation	English pronunciation
  !	exclamation mark (exclamation mark)	exclamation mark
  "	Double quotation marks	double quote
  #	pound sign (pound sign)	pound
  $	dollar	dollar
  %	percent sign (percent sign)	percent
  &	and	and
  '	Single quotation mark	left quote
  (	left parenthesis (left parenthesis)	left parenthesis
  )	right parenthesis (right parenthesis)	right parenthesis
  *	Star	asterisk
  +	plus (plus)	plus
  ,	comma (comma)	comma
  -	Bar	dash
  .	dot (dot)	dot
  /	slash (slash)	slash
  :	No colon	solon
  ；	semicolon (semicolon)	semicolon
  <	less than (less than)	less than
  =	equals sign (equals sign)	equals
  >	greater than (greater than)	greater than
  ?	question mark (question mark)	question mark
  @	at	at
  [	left bracket (left bracket)	left bracket
  \	backslash (backslash)	back slash
  ]	right bracket (right bracket)	right bracket
  ^	Caret	caret
  _	Underscore	underscore
  `	backtick (backtick)	back quote
  {	left brace (left brace)	left brace
  |	vertical bar (vertical bar)	vertical bar
  }	right brace (right brace)	right brace
  ~	Tilde	tilde
  ！	exclamation mark (exclamation mark)	exclamation mark
  "	Left double quotation mark	left double quote
  "	Right double quotation mark	right double qute
  '	left single quote (left single quote)	left quote
  '	Right single quotation mark	right quote
  (	left parenthesis (left parenthesis)	left parenthesis
  )	Closing parenthesis	right parenthesis
  ，	Comma	comma
  。	Period	full stop
  —	Bar	em dash
  :	colon (colon)	colon
  ；	semicolon (semicolon)	semicolon
  ？	question mark	question mark
  、	enumeration comma (enumeration comma)	enumeration comma
  …	ellipsis	ellipsis
  ……	ellipsis (ellipsis)	ellipsis
  《	left guillemet (left guillemet)	left guillemet
  》	Closing Book Title Mark	right guillemet
  ￥	yuan sign (yuan sign)	yuan
  ≥	greater than or equal to (greater than or equal to)	greater than or equal to
  ≤	less than or equal to (less than or equal to)	less than or equal to
  ≠	Not equal to	not equal
  ≈	approximately equal to (approximately equal to)	approximately equal
  ±	plus or minus (plus or minus)	plus or minus
  ×	Multiply	times
  π	Dispatch	pi
  Α	Alpha	alpha
  Β	beta (beta)	beta
  Γ	gamma (gamma)	gamma
  Δ	delta (delta)	delta
  Ε	epsilon (epsilon)	epsilon
  Ζ	Jetta	zeta
  Θ	Xita	theta
  Ι	iota (iota)	iota
  Κ	kappa (kappa)	kappa
  ∧	lambda (lambda)	lambda
  Μ	Miao	mu
  Ν	Persistent	nu
  Ξ	Kexi	ksi
  Ο	omicron (omicron)	omicron
  ∏	pi (pi)	pi
  Ρ	Flexible	rho
  ∑	Sigma	sigma
  Τ	Suite	tau
  Υ	upsilon (upsilon)	upsilon
  Φ	Failed	phi
  Χ	Device	chi
  Ψ	Pusai	psi
  Ω	omega (omega)	omega
  α	alpha (alpha)	alpha
  β	Beta	beta
  γ	gamma (gamma)	gamma
  δ	delta (delta)	delta
  ε	epsilon (epsilon)	epsilon
  ζ	zeta (zeta)	zeta
  η	Yita	eta
  θ	Theta	theta
  ι	iota (iota)	iota
  κ	kappa (kappa)	kappa
  λ	Lambda	lambda
  μ	mu (mu)	mu
  ν	Awkward	nu
  ξ	Kexi	ksi
  ο	Omicron	omicron
  π	Dispatching	pi
  ρ	Flexibility	rho
  σ	Sigma	sigma
  τ	Suite	tau
  υ	upsilon (upsilon)	upsilon
  φ	fai	phi
  χ	Device	chi
  ψ	psi (psi)	psi
  ω	Omega	omega

• The following table lists common units of measurement.

  Format	Category	Chinese example	English example
  Abbreviation	Length	nm (nanometer), μm (micrometer), mm (millimeter), cm (centimeter), m (meter), km (kilometer), ft (foot), in (inch)	nm (nanometre), μm (micrometre), mm (millimetre), cm (centimetre), m (metre), km (kilometre), ft (foot), in (inch)
  	Area	cm² (square centimeter), ㎡ (square meter), km² (square kilometer), SqFt (square foot)	cm² (square centimetre), ㎡ (square metre), km2 (square kilometre), SqFt (square foot)
  	Volume	cm³ (cubic centimeter), m³ (cubic meter), km³ (cubic kilometer), mL (milliliter), L (liter), gallon	cm³ (cubic centimetre), m³ (cubic metre), km3(cubic kilometre), mL (millilitre), L (millilitre), gal (gallon)
  	Weight	μg (microgram), mg (milligram), g (gram), kg (kilogram)	μg (microgram), mg (microgram), g (gram), kg (kilogram)
  	Time	min (minute), sec (second), ms (millisecond)	min (minute), sec (second), ms (millisecond)
  	Electromagnetic	μA (microampere), mA (milliampere), Ω (ohm), Hz (hertz), kHz (kilohertz), MHz (megahertz), GHz (gigahertz), V (volt), kV (kilovolt), kWh (kilowatt-hour)	μA (microamp), mA (milliamp), Hz (hertz), kHz (kilohertz), MHz (megahertz), GHz (gigahertz), V (volt), kV (kilovolt), kWh (kilowatt hour)
  	Sound	dB (decibel)	dB (decibel)
  	Atmospheric pressure	Pa (pascal), kPa (kilopascal), MPa (megapascal)	Pa (pascal), kPa (kilopascal), MPa (megapascal)
  Other common units		Supports Chinese units beyond those listed above, such as "meter", "second", "dollar", "milliliter per bottle", etc., along with Chinese classifiers like "aircraft", "session", "head", "unit", "pot", etc.	Supports measurement units beyond those listed above, such as tsp (teaspoon), rpm (round per minute), KB (kilobyte), mmHg (millimeter of mercury), etc.

Tag relationships

The <say-as> tag can contain text.

Examples

• cardinal

  <speak><say-as interpret-as="cardinal">12345</say-as></speak>

  Chinese audio effect: SSML-say-as_Cardinal.mp3

  <speak><say-as interpret-as="cardinal">10234</say-as></speak>

  English audio effect: en-SSML-say-as_cardinal.mp3

• digits

  <speak><say-as interpret-as="digits">12345</say-as></speak>

  Chinese audio effect: SSML-say-as_digit.mp3

  <speak><say-as interpret-as="digits">10234</say-as></speak>

  English audio effect: en-SSML-say-as_digits.mp3

• telephone

  <speak><say-as interpret-as="telephone">12345</say-as></speak>

  Chinese audio effect: SSML-say-as_Telephone.mp3

  <speak><say-as interpret-as="telephone">10234</say-as></speak>

  English audio effect: en-SSML-say-as_telephone.mp3

• name

  <speak>Her former name was <say-as interpret-as="name">Zeng Xiaofan</say-as></speak>

  Audio effect: SSML-say-as_Name.mp3

• address

  <speak><say-as interpret-as="address">Fulu International Building 1, Unit 3, Room 304</say-as></speak>

  Audio effect: SSML-say-as_Address.mp3

• id

  <speak><say-as interpret-as="id">myid_1998</say-as></speak>

  Audio effect: SSML-say-as_id.mp3

• characters

  <speak><say-as interpret-as="characters">Greek letters αβ</say-as></speak>

  Chinese audio effect: SSML-say-as_characters.mp3

  <speak><say-as interpret-as="characters">*b+3.c$=α</say-as></speak>

  English audio effect: en-SSML-say-as_characters.mp3

• punctuation

  <speak><say-as interpret-as="punctuation"> -./:;</say-as></speak>

  Audio effect: SSML-say-as_punctuation.mp3

• date

  <speak><say-as interpret-as="date">1000-10-10</say-as></speak>

  Chinese audio effect: SSML-say-as_date.mp3

  <speak><say-as interpret-as="date">10-01-2020</say-as></speak>

  English audio effect: en-SSML-say-as_date.mp3

• time

  <speak><say-as interpret-as="time">5:00am</say-as></speak>

  Chinese audio effect: SSML-say-as_time.mp3

  <speak><say-as interpret-as="time">0500</say-as></speak>

  English audio effect: en-SSML-say-as_time.mp3

• currency

  <speak><say-as interpret-as="currency">13,000,000.00CNY</say-as></speak>

  Chinese audio effect: SSML-say-as_currency.mp3

  <speak><say-as interpret-as="currency">$1,000.01</say-as></speak>

  English audio effect: en-SSML-say-as_currency.mp3

• measure

  <speak><say-as interpret-as="measure">100m12cm6mm</say-as></speak>

  Chinese audio effect: SSML-say-as_measure.mp3

  <speak><say-as interpret-as="measure">1,000.01kg</say-as></speak>

  English audio effect: en-SSML-say-as_measure.mp3