numbers

✍️ google-blog-style

Source: https://developers.google.com/style/numbers\n\n# Numbers

Stay organized with collections

Save and categorize content based on your preferences.\n\n- Home\n- Products\n- Style\n\n\n## Page Summary\n\n- Spell out numbers zero through nine and use numerals for numbers 10 and greater, with exceptions for technical quantities and specific contexts like version numbers.\n- Use numerals for dimensions, percentages, currency, and measurements, ensuring proper formatting and units.\n- Express fractions as decimals when possible, and format ranges of numbers with hyphens.\n- For clarity, provide real-world examples and visuals to support comprehension of numerical concepts.\n- Write out ordinal numbers (first, second, third) instead of using numerals (1st, 2nd, 3rd).\n\nSpell out numbers zero through nine and use numerals for numbers 10 and greater, with exceptions for technical quantities and specific contexts like version numbers.\n\nUse numerals for dimensions, percentages, currency, and measurements, ensuring proper formatting and units.\n\nExpress fractions as decimals when possible, and format ranges of numbers with hyphens.\n\nFor clarity, provide real-world examples and visuals to support comprehension of numerical concepts.\n\nWrite out ordinal numbers (first, second, third) instead of using numerals (1st, 2nd, 3rd).\n\n\n## Ordinal numbers\n\nSpell out all ordinal numbers in text.\n\nRecommended: first, fifth, twelfth,

forty-third\n\nNot recommended: 1st, 5th, 12th, 43rd\n\n\n## Numbers as words\n\nThis section covers when to spell out numbers as words.\n\nIf it's important to have the number and associated noun together on the same line, use

a nonbreaking space between the number and the noun.\n\nIn general, spell out the following:\n\n- Numbers from zero through nine, except as noted in

Numbers as numerals.

Recommended:

two-day total

Recommended: four options

Recommended: five minutes

Recommended: nine developers\n- A number that starts a sentence.

Recommended: Fifteen

directories are created.

In some cases it's better to rearrange the sentence so that the number

appears later.

Recommended: In

general, avoid sending files larger than 164 MB as attachments.

Not recommended: 164 MB

is generally considered too large a file to send as an attachment.

Exception: It's okay, but non-optimal, to begin a

sentence with a four-digit year.\n- A number that is followed by a numeral.

Recommended: This

procedure creates fifteen 100,000-byte files.

But

Recommended: This

procedure creates 15 of the 100,000-byte files.\n- Indefinite and casual numbers.

Using words like millions or billions is fine for approximate numbers. For

precise numbers, use numerals.

Recommended: You

can specify thousands of combinations.

Recommended: The

API might return a list of a million songs.\n\nNumbers from zero through nine, except as noted in

Numbers as numerals.\n\nRecommended:

two-day total\n\nRecommended: four options\n\nRecommended: five minutes\n\nRecommended: nine developers\n\nA number that starts a sentence.\n\nRecommended: Fifteen

directories are created.\n\nIn some cases it's better to rearrange the sentence so that the number

appears later.\n\nRecommended: In

general, avoid sending files larger than 164 MB as attachments.\n\nNot recommended: 164 MB

is generally considered too large a file to send as an attachment.\n\nException: It's okay, but non-optimal, to begin a

sentence with a four-digit year.\n\nA number that is followed by a numeral.\n\nRecommended: This

procedure creates fifteen 100,000-byte files.\n\nBut\n\nRecommended: This

procedure creates 15 of the 100,000-byte files.\n\nIndefinite and casual numbers.\n\nUsing words like millions or billions is fine for approximate numbers. For

precise numbers, use numerals.\n\nRecommended: You

can specify thousands of combinations.\n\nRecommended: The

API might return a list of a million songs.\n\n\n## Numbers as numerals\n\nThis section covers when to use numerals to write numbers.\n\nIf it's important to have the number and associated noun together on the same line, use

a nonbreaking space between the number and the noun.\n\nIn general, use numerals for the following:\n\n- Numbers 10 and greater.

Recommended: The link expires in 24

hours.

Recommended: 18 years old

Recommended: 27 minutes

Recommended: 728 shipments

Recommended: 18,000,000 users

Recommended: 10 chapters

Recommended: 102 degrees

Exceptions: Always use numerals for the following items, even if

they're less than 10:

Version numbers.

Recommended:

version 3

Technical quantities, such as amounts of memory, amounts of disk

space, numbers of queries, or usage limits.

Recommended: 6 queries per second

Recommended: 50 Mbps

Recommended: 64-bit

Page numbers.

Chapter numbers, sections, pages, and so on.

Step numbers. Avoid referring to step numbers whenever possible,

but in edge cases where you have no choice or it makes the most sense,

use the numeral.

Prices.

Numbers without units, such as numbers used in mathematical

expressions.

Numbers less than 10 when they appear in the same sentence with

numbers greater than 9.

Recommended: The

menu contains 15 options but 6 of them are deselected.\n- Version numbers.

Recommended:

version 3\n- Technical quantities, such as amounts of memory, amounts of disk

space, numbers of queries, or usage limits.

Recommended: 6 queries per second

Recommended: 50 Mbps

Recommended: 64-bit\n- Page numbers.\n- Chapter numbers, sections, pages, and so on.\n- Step numbers. Avoid referring to step numbers whenever possible,

but in edge cases where you have no choice or it makes the most sense,

use the numeral.\n- Prices.\n- Numbers without units, such as numbers used in mathematical

expressions.\n- Numbers less than 10 when they appear in the same sentence with

numbers greater than 9.

Recommended: The

menu contains 15 options but 6 of them are deselected.\n- Negative numbers.\n- Most fractions.\n- Percentages.\n- Dimensions.\n- Numbers containing decimal points.

Treat decimal numbers as plural even when less than or equal to 1.0.

Recommended: 1.0 inches

For decimal numbers less than one, place a zero in front of the decimal point.

Recommended: 0.3 inches\n- Treat decimal numbers as plural even when less than or equal to 1.0.

Recommended: 1.0 inches

For decimal numbers less than one, place a zero in front of the decimal point.

Recommended: 0.3 inches\n- For decimal numbers less than one, place a zero in front of the decimal point.

Recommended: 0.3 inches\n- Measurements.

Recommended: 8 pixels\n- Numbers in a range.\n\nNumbers 10 and greater.\n\nRecommended: The link expires in 24

hours.\n\nRecommended: 18 years old\n\nRecommended: 27 minutes\n\nRecommended: 728 shipments\n\nRecommended: 18,000,000 users\n\nRecommended: 10 chapters\n\nRecommended: 102 degrees\n\nExceptions: Always use numerals for the following items, even if

they're less than 10:\n\n- Version numbers.

Recommended:

version 3\n- Technical quantities, such as amounts of memory, amounts of disk

space, numbers of queries, or usage limits.

Recommended: 6 queries per second

Recommended: 50 Mbps

Recommended: 64-bit\n- Page numbers.\n- Chapter numbers, sections, pages, and so on.\n- Step numbers. Avoid referring to step numbers whenever possible,

but in edge cases where you have no choice or it makes the most sense,

use the numeral.\n- Prices.\n- Numbers without units, such as numbers used in mathematical

expressions.\n- Numbers less than 10 when they appear in the same sentence with

numbers greater than 9.

Recommended: The

menu contains 15 options but 6 of them are deselected.\n\nRecommended:

version 3\n\nTechnical quantities, such as amounts of memory, amounts of disk

space, numbers of queries, or usage limits.

Recommended: 6 queries per second

Recommended: 50 Mbps

Recommended: 64-bit\n\nRecommended: 6 queries per second\n\nRecommended: 50 Mbps\n\nRecommended: 64-bit\n\nNumbers less than 10 when they appear in the same sentence with

numbers greater than 9.\n\nRecommended: The

menu contains 15 options but 6 of them are deselected.\n\n- Treat decimal numbers as plural even when less than or equal to 1.0.

Recommended: 1.0 inches

For decimal numbers less than one, place a zero in front of the decimal point.

Recommended: 0.3 inches\n- For decimal numbers less than one, place a zero in front of the decimal point.

Recommended: 0.3 inches\n\nTreat decimal numbers as plural even when less than or equal to 1.0.\n\nRecommended: 1.0 inches\n\nFor decimal numbers less than one, place a zero in front of the decimal point.\n\nRecommended: 0.3 inches\n\nMeasurements.\n\nRecommended: 8 pixels\n\n\n## Numbers as Roman numerals\n\nIn general, avoid using Roman numerals when possible. Instead, use Arabic numerals because they

are easier to scan.\n\nYou can use Roman numerals for

sub-steps in numbered procedures.\n\n\n## Fractions\n\nExpress fractions as decimal numbers, when possible.\n\nIf you must express fractions as words, connect the numerator and

denominator with a hyphen unless one of them is already hyphenated.\n\nRecommended: 0.75\n\nRecommended: one and one-half\n\nRecommended: two-fifths\n\nRecommended: five sixty-fourths\n\n\n## Percentages\n\nIn general, use numerals and the percent sign (%), without a space between them.\n\nRecommended: 40%\n\nException: If the percentage starts the sentence, then spell out both

the number and the word percent.\n\nRecommended: Forty

percent of the files\n\n\n## Ranges of numbers\n\nUse a hyphen with no space on either side of it. Do not use an

en dash (–).\n\nRecommended:

2012-2016\n\nFor more information, see the following:\n\n- Ranges of numbers with units\n- Range of numbers\n\n\n## Suspended hyphens\n\nWhen two or more hyphenated compounds that start with numbers modify the same

word, use suspended hyphens.\n\nRecommended: You can set up the system to

scan for new files at one-, two-, or three-hour intervals.\n\n\n## Currency\n\nMake sure that it's clear what country's currency you are describing. For more information, see

the currency section in Units of measurement.\n\nFor US dollars, use a comma to delineate the thousands place of whole

currency. Use a period to delineate whole currency and fractions of currency.

Always include the dollar sign ($) at the beginning of the currency. Do

not use any punctuation or spaces to the right of the decimal.\n\nRecommended: The price is $0.006653 per

vCPU hour.\n\nNot recommended: The price is $0.006,653

per vCPU hour.\n\nRecommended: $10,000 in fees is out of

reach for many developers.\n\nNot recommended: $10 000 in fees is out

of reach for many developers.\n\n\n## Commas and decimal points in numbers\n\nUse commas and decimal points in accordance with standard American number-formatting.\n\nSpecifically: in numbers four or more digits long, use commas to set off

groups of three digits, counting leftward from the decimal point, in the

standard American style. For long decimal numbers, do not use any digit-group separators to the

right of the decimal point.\n\nUse a period for a decimal point, also in the standard American style.\n\n\nRecommended | Not recommended\nThe limit is 1,532,784 bytes per day. | The limit is 1532784 bytes per day.\nThe API supports up to 2,000 vertices. | The API supports up to 2000 vertices.\n0.031611/vCPU hour | 0.031 611/vCPU hour\n\nFor more information about decimal points and digit group separators, see Wikipedia's decimal mark entry.\n\n\n## Dimensions\n\nUse numerals for dimensions.\n\nUse a lowercase x between the numerals in the dimensions, with no space between

the numerals and the x.\n\nRecommended: 192x192\n\nNot recommended: 192 x 192\n\n\n## Exponents\n\nUse

standard mathematical notation.

Don't put a space between the base and the exponent.\n\nRecommended: 23\n\n\n## Accompany numerical concepts with real-world practical implications\n\nAccompany numerical concepts with real-world practical implications to provide tangible meaning.

For example, if using a feature incurs additional fees, add a link to pricing calculator.\n\n\n## Provide visuals for math concepts\n\nAccompany math concepts and numerals with

diagrams or other images

to support comprehension. For example, if comparing statistics, consider illustrating percentages in

a pie chart or a bar graph.\n