Functions
def	nice_number_en (number, speech, denominators)

def	nice_time_en (dt, speech=True, use_24hour=False, use_ampm=False)

def	pronounce_number_en (num, places=2, short_scale=True, scientific=False)

Function Documentation

def mycroft.util.lang.format_en.nice_number_en	(	number,
		speech,
		denominators
	)

English helper for nice_number

This function formats a float to human understandable functions. Like
4.5 becomes "4 and a half" for speech and "4 1/2" for text

Args:
    number (int or float): the float to format
    speech (bool): format for speech (True) or display (False)
    denominators (iter of ints): denominators to use, default [1 .. 20]
Returns:
    (str): The formatted string.

Definition at line 24 of file format_en.py.

def mycroft.util.lang.format_en.nice_time_en	(	dt,
		speech = `True`,
		use_24hour = `False`,
		use_ampm = `False`
	)

Format a time to a comfortable human format

For example, generate 'five thirty' for speech or '5:30' for
text display.

Args:
    dt (datetime): date to format (assumes already in local timezone)
    speech (bool): format for speech (default/True) or display (False)=Fal
    use_24hour (bool): output in 24-hour/military or 12-hour format
    use_ampm (bool): include the am/pm for 12-hour format
Returns:
    (str): The formatted time string

Definition at line 229 of file format_en.py.

def mycroft.util.lang.format_en.pronounce_number_en	(	num,
		places = `2`,
		short_scale = `True`,
		scientific = `False`
	)

Convert a number to its spoken equivalent

For example, '5.2' would return 'five point two'

Args:
    num(float or int): the number to pronounce (under 100)
    places(int): maximum decimal places to speak
    short_scale (bool) : use short (True) or long scale (False)
        https://en.wikipedia.org/wiki/Names_of_large_numbers
    scientific (bool): pronounce in scientific notation
Returns:
    (str): The pronounced number

Definition at line 69 of file format_en.py.

Functions

Function Documentation