Retrieve an {Toybox::Lang::Array Array} of the current heart rate zone
threshold values in beats per minute (bpm)

The returned Array contains zone values as follows:
* min zone 1 - The minimum heart rate threshold for zone 1
* max zone 1 - The maximum heart rate threshold for zone 1
* max zone 2 - The maximum heart rate threshold for zone 2
* max zone 3 - The maximum heart rate threshold for zone 3
* max zone 4 - The maximum heart rate threshold for zone 4
* max zone 5 - The maximum heart rate threshold for zone 5
@example Use the HR_ZONE_SPORT_* enum to get the zone for that specific sport
using Toybox.UserProfile;
var genericZoneInfo = UserProfile.getHeartRateZones(UserProfile.HR_ZONE_SPORT_GENERIC);
sport [Toybox::UserProfile::SportHrZone] The sport that zones are being

requested from. Should be a {Toybox::UserProfile::HR_ZONE_SPORT_GENERIC HR_ZONE_SPORT_*} value.
Returns [Toybox::Lang::Array] An Array of zone thresholds for the

requested sport.
@since 1.2.6
]]> Return the sport for which the current activity retrieves heart rate
zone thresholds.

If the active sport does not have sport specific zones, it will return
{Toybox::UserProfile::HR_ZONE_SPORT_GENERIC HR_ZONE_SPORT_GENERIC}.
@example
using Toybox.UserProfile;
var profile = UserProfile.getCurrentSport();
Returns [Toybox::UserProfile::SportHrZone]

The current HR zone sport from the
{Toybox::UserProfile::HR_ZONE_SPORT_GENERIC HR_ZONE_SPORT_*} enum.
@since 1.2.6
]]> Retrieve the current {Toybox::UserProfile::Profile Profile}
object.
@example
using Toybox.UserProfile;
var profile = UserProfile.getProfile();
Returns [Toybox::UserProfile::Profile] The Profile object for the

current user
@since 1.0.0
]]> Get the current {Toybox::Position::Info Position.Info}.

Using this API requires enabling the Positioning Permission.
This is useful for retrieving the current position info either on demand
or periodically within a {Toybox::Timer::Timer Timer}.
Returns [Toybox::Position::Info]

@example Get position info once per second
using Toybox.Position;
using Toybox.System;
using Toybox.Timer;
var dataTimer = new Timer.Timer();
dataTimer.start(method(:timerCallback), 1000, true); // A one-second timer
function timerCallback() {
var positionInfo = Position.getInfo();
if (positionInfo has :altitude && positionInfo.altitude != null) {
var altitude = positionInfo.altitude;
System.println("Altitude: " + altitude);
}
}
@since 1.0.0
]]> Convert a String to a Location object.

The input String must be in one of the four formats described by the
Position.GEO_* constants.
string [Toybox::Lang::String] The String to parse

format [Toybox::Position::CoordinateFormat] A Position.GEO_* value

Returns [Toybox::Position::Location] A Location object representing the

position described by the input String
@example
using Toybox.Position;
using Toybox.System;
var locString = "38.856147, -94.800953";
var myLocation = Position.parse(locString, Position.GEO_DEG);
System.println(myLocation.toRadians()); // [0.678168, -1.654589]
@since 1.0.0
]]> Convert {Toybox::Position::Info Position.Info} into a String
Returns [Toybox::Lang::String]

@since 1.0.0
]]> Request a Location event.

Using this API requires enabling the Positioning Permission.
Only Device Apps and Widgets may use this API.
options [Toybox::Lang::Number,Toybox::Lang::Dictionary] A LOCATION_* value or {Toybox::Lang::Dictionary} of options.

@option options [Toybox::Position::LocationAcquisitionType] :acquisitionType A LOCATION_* enum value indicating the
position acquisition type to use.
@option options [Toybox::Lang::Array] :constellations An array of CONSTELLATION_* enum values
specifying what constellations to enable. If not provided, CONSTELLATION_GPS will be used by default.
listener [Toybox::Lang::Method] A reference to a listener method:

* Called when location updates are received
* Receives a Position.Info object
@option options [Toybox::Position::Configuration] :configuration A CONFIGURATION_* value
specifying what configuration to enable. Only available with ConnectIQ 3.3.6 and later.
@option options [Toybox::Position::PositioningMode] :mode a POSITIONING_MODE_* value specifying the mode to use.
If +null+ POSITIONING_MODE_NORMAL will be used by default.
@throws [Toybox::Lang::InvalidValueException] Thrown if :acquisitionType is invalid, if a
specific CONSTELLATION_* value is not supported by a device, or if an invalid combination of
constellation values are specified.
@note Passing an options {Toybox::Lang::Dictionary Dictionary} is only supported with ConnectIQ 3.2.0 and later.
@note Passing the +:configuration+ option is only supported with ConnectIQ 3.3.6 or later.
@note Multitasking: Location events will be disabled when app enters inacitve state, and re-enabled when is active again.
These state changes are denoted by calls to AppBase.onActive() and AppBase.onInactive().
@example
using Toybox.Position;

var options = {
:acquisitionType => Position.LOCATION_CONTINUOUS
};

if (Position has :POSITIONING_MODE_AVIATION) {
options[:mode] = Position.POSITIONING_MODE_AVIATION;
}

if (Position has :hasConfigurationSupport) {
if (Position has :CONFIGURATION_GPS_GLONASS_GALILEO_BEIDOU_L1_L5) &&
(Position.hasConfigurationSupport(Position.CONFIGURATION_GPS_GLONASS_GALILEO_BEIDOU_L1_L5)) {
options[:configuration] = Position.CONFIGURATION_GPS_GLONASS_GALILEO_BEIDOU_L1_L5;
} else if (Position has :CONFIGURATION_GPS_GLONASS_GALILEO_BEIDOU_L1) &&
(Position.hasConfigurationSupport(Position.CONFIGURATION_GPS_GLONASS_GALILEO_BEIDOU_L1)) {
options[:configuration] = Position.CONFIGURATION_GPS_GLONASS_GALILEO_BEIDOU_L1;
} else if (Position has :CONFIGURATION_GPS) &&
(Position.hasConfigurationSupport(Position.CONFIGURATION_GPS)) {
options[:configuration] = Position.CONFIGURATION_GPS;
}
} else if (Position has :CONSTELLATION_GLONASS) {
// this can fail with InvalidValueException if combination is not supported by device
options[:constellations] = [ Position.CONSTELLATION_GPS, Position.CONSTELLATION_GLONASS ];
} else {
options = Position.LOCATION_CONTINUOUS;
}

// Continuous location updates using selected options
Position.enableLocationEvents(options, method(:onPosition));

function onPosition(info) {
var myLocation = info.position.toDegrees();
}

@since 1.0.0
]]> Control the display backlight.

The backlight will always respect the backlight timeout settings on the device.
Behavior of this feature may also change depending on device settings. For example, if a device is set to activate the back light with key
presses, the backlight will toggle on with key presses even if the app is written to turn off the back light with a key press.

On products that use a gesture enabled display, calling this API will suppress the gesture detection for the period that the backlight is
on. Calling this repeatedly can hold the display on, but if the product has burn in protection an exception will be thrown if you attempt
to keep the display enabled for too long (e.g. over 1 minute).

setting [Toybox::Lang::Boolean, Toybox::Lang::Float]

* If +setting+ is a {Toybox::Lang::Boolean Boolean}, +false+ will disable the backlight and +true+
will enable the backlight at the system backlight level.
* If +setting+ is a {Toybox::Lang::Float Float}, the value 0.0 will disable the backlight and values
greater than 0.0 and less than or equal to 1.0 will enable the backlight at the specified brightness.
@note Passing a {Toybox::Lang::Float Float} is only supported with ConnectIQ 3.2.1 and later.
@throws BacklightOnTooLongException On products with burn in protection, this exception is thrown if the backlight
is held on for too long continuously
@throws InvalidOptionsException If the Float value is outside the valid range.
@since 1.0.0
]]> Engage the vibration motor.

The vibrate method takes an Array containing at least one
{Toybox::Attention::VibeProfile VibeProfile} object, up to a maximum of 8,
and runs them in sequence.
@note Forerunner devices do not support vibration patterns. Vibration may
still be used, but the vibration will always run at the same duty cycle.
vibeProfiles [Toybox::Lang::Array] An Array of

{Toybox::Attention::VibeProfile VibeProfile} objects
@example Vibrate in an on/off pattern
if (Attention has :vibrate) {
vibeData =
[
new Attention.VibeProfile(50, 2000), // On for two seconds
new Attention.VibeProfile(0, 2000), // Off for two seconds
new Attention.VibeProfile(50, 2000), // On for two seconds
new Attention.VibeProfile(0, 2000), // Off for two seconds
new Attention.VibeProfile(50, 2000) // on for two seconds
];
}
Attention.vibrate(vibeData);
@see Toybox::Attention::VibeProfile
@since 1.0.0
]]> Play a tone.
options [Toybox::Attention::Tone, Toybox::Lang::Dictionary] A TONE_* value or

{Toybox::Lang::Dictionary Dictionary} of options.
@option options [Toybox::Lang::Array] :toneProfile Array containing at least one
{Toybox::Attention::ToneProfile ToneProfile} object to be played in sequence.
@option options [Toybox::Lang::Number] :repeatCount Number of times to repeat the given
tone sequence.
@note Passing an options {Toybox::Lang::Dictionary Dictionary} is only supported with ConnectIQ 3.1.0 and later.
@example
using Toybox.Attention;

// Play a predefined tone
if (Attention has :playTone) {
Attention.playTone(Attention.TONE_LOUD_BEEP);
}

// Use an array of ToneProfile objects to build and play a custom tone
if (Attention has :ToneProfile) {
var toneProfile =
[
new Attention.ToneProfile( 2500, 250),
new Attention.ToneProfile( 5000, 250),
new Attention.ToneProfile(10000, 250),
new Attention.ToneProfile( 5000, 250),
new Attention.ToneProfile( 2500, 250),
];
Attention.playTone({:toneProfile=>toneProfile});
}

@throws [Toybox::Lang::InvalidOptionsException]
Thrown if passing an options hash with invalid values when using new ToneProfile objects
@since 1.0.0
]]> Native function called after constructing the query string for GET requests

@see Toybox::Communications#makeImageRequestNative2
@deprecated This method may be removed after System 8.
@since 1.2.0
]]> Initiate a download request.

Web requests are asynchronous. The supplied response callback method
will be called when the request returns.
@example
// It is common for developers to wrap a makeWebRequest() call in a function
// as displayed below. The function defines the variables for each of the
// necessary arguments in a Communications.makeWebRequest() call, then passes
// these variables as the arguments. This allows for a clean layout of your web
// request and expandability.
using Toybox.System;
using Toybox.Communications;

// set up the response callback function
function onReceive(responseCode, data) {
if (responseCode == 200) {
System.println("Request Successful"); // print success
}
else {
System.println("Response: " + responseCode); // print response code
};

};

function makeRequest() {
var url = "https://www.garmin.com"; // set the url

var params = { // set the parameters
"definedParams" => "123456789abcdefg"
};

var options = { // set the options
:method => Communications.HTTP_REQUEST_METHOD_GET, // set HTTP method
:headers => { // set headers
"Content-Type" => Communications.REQUEST_CONTENT_TYPE_URL_ENCODED},
// set response type
:responseType => Communications.HTTP_RESPONSE_CONTENT_TYPE_URL_ENCODED
};

var responseCallback = method(:onReceive); // set responseCallback to
// onReceive() method
// Make the Communications.makeWebRequest() call
Communications.makeWebRequest(url, params, options, responseCallback);
}
url [Toybox::Lang::String] The URL being requested

parameters [Toybox::Lang::Dictionary] A Dictionary of keys and

values.
* These values should not be URL encoded.
* Can be +null+.
options [Toybox::Lang::Dictionary] A Dictionary of

options.
responseCallback [Toybox::Lang::Method] A reference to

a callback method which must accept two arguments:
* responseCode: The server response code or a BLE_* error type
* data: The content if the request was successful, or +null+
@option options [Toybox::Communications::HttpRequestMethod] :method The HTTP method of the
request. This should be an HTTP_REQUEST_METHOD_* value.
@option options [Toybox::Lang::Dictionary] :headers A Dictionary of HTTP
headers to include in the request.
* The "Content-Type" header for the body of the request can be specified using a {Toybox::Communications REQUEST_CONTENT_TYPE_*} value.
* If the content type is not specified, it will default to "application/json" for GET and DELETE requests, and will default to "application/x-www-form-urlencoded" for POST and PUT requests.
* By default, DELETE requests will have their parameters appended to the URL.
* Setting the method as DELETE as well as a "Content-Type" header will result in the parameters being set in the body of the request and they will not be appended to the URL.
* GET requests can only have their parameters appended to the URL, specifying the "Content-Type" header will not set the body.
@option options [Toybox::Communications::HttpResponseContentType] :responseType The format of the response.
* This should be an {Toybox::Communications HTTP_RESPONSE_CONTENT_TYPE_*} value.
* If HTTP_RESPONSE_CONTENT_TYPE_FIT or HTTP_RESPONSE_CONTENT_TYPE_GPX is given, the system will attempt to download and parse a FIT or GPX file and store the contained data in the device, based on the contents of the file.
* If not given, the system will use the Content-Type header from the server response to determine the format of the response body. If the Content-Type header from the response is not one of the known HTTP_RESPONSE_CONTENT_TYPE_* types, an error will occur.
@option options [Toybox::Lang::Object] :context A user-specific context object to be passed to the
response callback. The callback will need to accept a third parameter if this value is
populated.
@option options [Toybox::Media::Encoding] :mediaEncoding The encoding of
the audio content that is being downloaded. Should be a
{Toybox::Media Media.ENCODING_*} value.
@option options [Toybox::Lang::Number] :maxBandwidth maximum bandwidth.
TVM will select the audio stream with the highest bandwidth that's less than or equal to the maximum
This option is only effective when processing HLS content
@option options [Toybox::Lang::Method] :fileDownloadProgressCallback
a callback method which must accept two parameters
* totalBytesTransferred: The total number of bytes transferred for the current file download
* fileSize: The size of the file being downloaded. Note that this can be +null+ if file size cannot be determined from the server.
* This option is only supported for media file download progress
* This option is supported since CIQ 3.2.0
@throws [Toybox::Lang::InvalidOptionsException]
Thrown if a required option for a particular request is omitted
@throws [Toybox::Lang::SymbolNotAllowedException]
Thrown if a given :responseType option is not supported for the device the request is being made from.
An example would be using HTTP_RESPONSE_CONTENT_TYPE_AUDIO on a device that does not support audio content provider apps
@note This method can be used when connected to WiFi or a mobile device over Bluetooth.
@since 1.3.0
]]> Build a URL string with GET parameters

url [Toybox::Lang::String] The base URL with no parameters

params [Toybox::Lang::Dictionary] The dictionary of params and values

urlEncode [Toybox::Lang::Boolean] If +true+, the keys and values will be url encoded before appending

Returns [Toybox::Lang::String]

@since 1.0.0
]]> Convert a URL String into a percent-encoded string.

The reserved characters in the string will be replaced with their
corresponding hex-value pairs. This follows the URI-encoding scheme as
detailed by RFC 3986.
@see https://www.ietf.org/rfc/rfc3986.txt RFC 3986
url [Toybox::Lang::String] The URL String to be encoded

Returns [Toybox::Lang::String] A percent-encoded String

@since 1.1.2
]]> Initiate an image download request.

GCM will scale and dither the image based on the capabilities of the
device, but the user will be able to pass additional options (like
dithering it down to a one color image)
@example
using Toybox.System;
using Toybox.Communications;

var image;
var responseCode;

// Set up the responseCallback function to return an image or null
function responseCallback(responseCode, data) {
responseCode = responseCode;
if (responseCode == 200) {
image = data;
} else {
image = null;
}
}

// wrap the request in a function
function makeRequest() {
var url = "http://www.garmin.com/image-path"; // set the image url
var parameters = null; // set the parameters
var options = { // set the options
:palette => [ Gfx.COLOR_ORANGE, // set the palette
Gfx.COLOR_DK_BLUE,
Gfx.COLOR_BLUE,
Gfx.COLOR_BLACK ],
:maxWidth => 100, // set the max width
:maxHeight => 100, // set the max height
:dithering => Communications.IMAGE_DITHERING_NONE // set the dithering
};

// Make the image request
Communications.makeImageRequest(url, parameters, options, method(:responseCallback));
}
url [Toybox::Lang::String] The URL of an image to request

parameters [Toybox::Lang::Dictionary, null] The Dictionary of keys and

values
* Appended to the URL
* Can be +null+
options [Toybox::Lang::Dictionary] Additional image options

@option options [Toybox::Lang::Array] :palette The color palette to restrict the image
dithering to. Using a smaller palette can reduce the size of the image
data to speed up transfers
@option options [Toybox::Lang::Number] :maxWidth The maximum width an
image should be scaled to
@option options [Toybox::Lang::Number] :maxHeight The maximum height an
image should be scaled to
@option options [Toybox::Communications::Dithering] :dithering The type of dithering
to use when processing the image. Defaults to
{Toybox::Communications::IMAGE_DITHERING_FLOYD_STEINBERG IMAGE_DITHERING_FLOYD_STEINBERG}
@option options [Toybox::Communications::PackingFormat] :packingFormat The format of the
image data to request. Defaults to
{Toybox::Communications::PACKING_FORMAT_DEFAULT PACKING_FORMAT_DEFAULT}
responseCallback [Toybox::Lang::Method] A reference to a callback

method which must accept two arguments:
* responseCode: The server response code or a BLE_* error type
* data: A {Toybox::WatchUi::BitmapResource BitmapResource} or {Toybox::Graphics::BitmapReference BitmapReference} from a successful request, or +null+ on error
@note This method can be used when connected to WiFi or a mobile device over Bluetooth.
@since 1.2.0
]]> Get the MailboxIterator for this Application's mailbox.
Returns [Toybox::Communications::MailboxIterator] Iterator for the

mailbox
@since 1.0.0
@deprecated This method may be removed after System 4.
@see Toybox::Communications#registerForPhoneAppMessages Communications.registerForPhoneAppMessages()
]]> Add a listener for mailbox events.

The listener method is called whenever a new message is received.
listener [Toybox::Lang::Method] A reference to a

callback method which must accept an iterator. The iterator is the
mailbox iterator for the app
@since 1.0.0
@deprecated This method may be removed after System 4.
@see Toybox::Communications#registerForPhoneAppMessages Communications.registerForPhoneAppMessages()
]]> Register a callback for receiving OAuth messages.

The callback will be called once for each received OAuth message.
If there are messages waiting for the app when this function is
called, the callback will immediately be called once for each waiting
message.
method [Toybox::Lang::Method] A reference to a callback, which

must receive a +data+ argument of the type
{Toybox::Communications::OAuthMessage OAuthMessage}.
@example
using Toybox.Communications;

function onOAuthMessage(message) {
if (message.data != null) {
var code = message.data[OAUTH_CODE];
var error = message.data[OAUTH_ERROR];
} else {
// return an error
}
}
Communications.registerForOAuthMessages(method(:onOAuthMessage));

@since 1.3.0
]]> @since 1.2.0
]]> Cancel all pending JSON and Image requests.

The number of active requests running in parallel is limited in the
Connect IQ platform. This call will cancel all outstanding requests.
@since 1.2.0
]]> Initiate a download request.

The request is asynchronous; the responseCallback will be called when
the request returns.
url [Toybox::Lang::String] The URL being requested

parameters [Toybox::Lang::Dictionary] A Dictionary of keys and

values
* Appended to the URL for GET/DELETE request
* Set as the body for a POST/PUT request
* These values must be URL encoded
* Can be +null+
options [Toybox::Lang::Dictionary] A Dictionary of options

* Can be +null+
@option options [Toybox::Communications::HttpRequestMethod] :method The HTTP method of the
request. This option should be an HTTP_REQUEST_METHOD_* value.
@option options [Toybox::Lang::Dictionary] :headers A Dictionary of HTTP
headers to include in the request
* The "Content-Type" header for the body of the request can be specified using a REQUEST_CONTENT_TYPE_* value
* This is only valid for methods PUT and POST (you cannot set a body for a GET or DELETE request)
* If the content type is not specified, it will default to "application/json" for GET and DELETE requests, and will default to "application/x-www-form-urlencoded" for POST and PUT requests
responseCallback [Toybox::Lang::Method] A reference to a

callback method which must accept two arguments:
* responseCode: the server response code
* data: the content if the request was successful, or +null+
@since 1.0.0
@deprecated This method may be removed after System 4.
@note This method can be used when connected to WiFi or a mobile device over Bluetooth.
@see Toybox::Communications#makeWebRequest Communications.makeWebRequest().
]]> Send data across the the BLE link.

Support for transmittable types has been expanded over time.
* {Toybox::Lang::ByteArray ByteArray} (Since 6.0.0)
content [Toybox::Communications::TransmitType] The object to be sent

options [Toybox::Lang::Dictionary] Additional transmit options

for future proofing. For now, an empty Dictionary is used.
listener [Toybox::Communications::ConnectionListener] An

extension of the ConnectionListener class
@since 1.0.0
]]> Register a callback for receiving Phone App messages.

The callback will be called once for each message received. If there are
messages waiting for the app when this function is called, the
callback will immediately be called once for each waiting message.
method [Toybox::Lang::Method] A reference to a callback, which

must receive a +data+ argument of the type
{Toybox::Communications::PhoneAppMessage PhoneAppMessage}.
@example
using Communications;

function phoneMessageCallback(msg as PhoneAppMessage) as Void {
System.println(Lang.format("Data: $1$", [ msg.data ]));
}

// register for messages
Communications.registerForPhoneAppMessages(method(:phoneMessageCallback));
@see Toybox::Communications::PhoneAppMessage
@see Toybox::Communications#registerForPhoneAppMessageErrors Communications.registerForPhoneAppMessageErrors()
@since 1.4.0
]]> Clear the contents of the mailbox.
@since 1.0.0
@deprecated This method may be removed after System 4.
@see Toybox::Communications#registerForPhoneAppMessages Communications.registerForPhoneAppMessages()
]]> Request that GCM issue a phone notification that will open a web page.

This method will push a phone notification that must be accepted by the
user. If the used accepts it, a web page defined by this method will be
opened in the default browser on the phone.
url [Toybox::Lang::String] The URL to open.

params [Toybox::Lang::Dictionary] The URL parameters used to add

to the pages web page URL.
Parameters should not be URL encoded.
options [Toybox::Lang::Dictionary] Additional options for the

request
@example
using Toybox.Communications;
Communications.openWebPage(
"http://www.bing.com/images/search",
{"q" => "cute kitten"},
null
);
// passes the url: http://bing.com/images/search?q=cute kitten to the
// browser on the phone
@note This method can only be used when connected to a mobile device over Bluetooth.
@since 1.3.0
]]> Request an OAuth sign-in through Garmin Connect Mobile.

A notification will trigger on the phone, that when clicked, provides a
web view that shows +requestUrl+. If the user grants permission to the app,
then the callback registered by
{Toybox::Communications#registerForOAuthMessages registerForOAuthMessages()}
will be called with an {Toybox::Communications::OAuthMessage OAuthMessage}
from the OAuth response.
@example
using Toybox.Communications;
using Toybox.System;

const CLIENT_ID = "myClientID";
const OAUTH_CODE = "myOAuthCode";
const OAUTH_ERROR = "myOAuthError";

// register a callback to capture results from OAuth requests
Communications.registerForOAuthMessages(method(:onOAuthMessage));

// wrap the OAuth request in a function
function getOAuthToken() {
status = "Look at OAuth screen\n";
Ui.requestUpdate();

// set the makeOAuthRequest parameters
var params = {
"scope" => Comm.encodeURL("https://www.serviceurl.com/"),
"redirect_uri" => "https://localhost",
"response_type" => "code",
"client_id" => $.CLIENT_ID
};

// makeOAuthRequest triggers login prompt on mobile device.
// "responseCode" and "responseError" are the parameters passed
// to the resultUrl. Check the oauth provider's documentation
// to determine the correct strings to use.
Comm.makeOAuthRequest(
"https://requesturl.com",
params,
"http://resulturl.com",
Comm.OAUTH_RESULT_TYPE_URL,
{"responseCode" => $.OAUTH_CODE, "responseError" => $.OAUTH_ERROR}
);
}

// implement the OAuth callback method
function onOAuthMessage(message) {
if (message.data != null) {
var code = message.data[$.OAUTH_CODE];
var error = message.data[$.OAUTH_ERROR];
} else {
// return an error
}
}
// the OAuth service can now be used with a makeWebRequest() call
requestUrl [Toybox::Lang::String] The URL to load in the web view

to begin authentication
requestParams [Toybox::Lang::Dictionary] Non-URL encoded parameters

for the +requestUrl+
resultUrl [Toybox::Lang::String] The URL of the final page of

authentication that contains the +resultKeys+
resultType [Toybox::Lang::TokenResult] An OAUTH_RESULT_TYPE_* value

that specifies the format of the result
resultKeys [Toybox::Lang::Dictionary] The desired OAuth response

values passed to the callback method. The keys map to the actual OAuth
response keys, and the values map to the keys of the
{Toybox::Communications::OAuthMessage OAuthMessage} data.
@note This method can only be used when connected to a mobile device over Bluetooth.
@since 1.3.0
]]> Generate the value for the "Authorization" header in an OAuth 1.0a
request.

The returned value can be set as the "Authorization" header for
{Toybox::Communications#makeWebRequest makeWebRequest()}.
@note It is recommended to use OAuth 2.0 instead of OAuth 1.0a. See {Toybox::Communications#makeOAuthRequest}.
url [Toybox::Lang::String] The request URL

params [Toybox::Lang::Dictionary] The parameters of the request

requestMethod [Toybox::Communications::HttpRequestMethod] An HTTP_REQUEST_METHOD_*

value
signatureMethod [Toybox::Communications::SigningMethod] An OAUTH_SIGNING_METHOD_*

value
token [Toybox::Lang::String, null] The token given by the OAuth

service
* Can be +null+
tokenSecret [Toybox::Lang::String] The token secret given by the

OAuth service. Used to sign the request
consumerKey [Toybox::Lang::String] The key that identifies your

application
consumerSecret [Toybox::Lang::String] The consumer secret that is

used to sign the request
Returns [Toybox::Lang::String] The value for the "Authorization" header

@since 1.3.0
@deprecated This method may be removed after System 10.
]]> Get the current Activity Info.
Returns [Toybox::Activity::Info] The current Activity Info or +null+ if

there is no current activity.
@since 1.0.0
]]> Create a formatted String by substituting the given parameters into the
given format at the corresponding locations.
format [Toybox::Lang::String] A string using $1$, $2$, $3$... as

substitution identifiers
parameters [Toybox::Lang::Array] The Array of content to substitute

into the formatted String
Returns [Toybox::Lang::String] A new String with the substituted content

@example
// Set the 'myString' variable to "Your next meeting is at 2:30 on Sep 4 in room 6820."
using Toybox.Lang
var myFormat = "Your next meeting is at $1$:$2$ on $3$ $4$ in room $5$.";
var myParams = [2, 30, "Sep", 4, "6820"];
var myString = Lang.format(myFormat, myParams);
@since 1.0.0
]]> Get a {Toybox::Time::Moment Moment} for the current time.

Returns [Toybox::Time::Moment] A Moment representing the current moment

in time.
@example Using now() on December 31, 1989 at 5:00 pm CST
using Toybox.Time;
var now = new Time.Moment(Time.now().value()); // UNIX epoch 631148400
@see https://en.wikipedia.org/wiki/Coordinated_Universal_Time UTC Time
@see https://en.wikipedia.org/wiki/Unix_time UNIX Time
@since 1.0.0
]]> Get a {Toybox::Time::Moment Moment} for midnight today.

Returns [Toybox::Time::Moment] A Moment representing the the beginning

of the current day.
@example Using today() on December 31, 1989 at 5:00 pm CST
using Toybox.Time;
var now = new Time.Moment(Time.today().value()); // UNIX epoch 631087200
@see https://en.wikipedia.org/wiki/Coordinated_Universal_Time UTC Time
@see https://en.wikipedia.org/wiki/Unix_time UNIX Time
@since 1.0.0
]]> Get the tangent of an angle.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The angle in radians
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The tangent value of x in radians
Toybox::Lang::Float if input is Toybox::Lang::Number or Toybox::Lang::Float
Toybox::Lang::Double if input is Toybox::Lang::Long or Toybox::Lang::Double
@since 1.0.0
]]> Get logarithm of a value using the specified base
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The value for which to get the logarithm
base [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The base value.
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

specified base logarithm of x
* Float if both inputs are Number or Float
* Double if either input is Long or Double
@since 1.0.0
]]> Get the cosine of an angle.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The angle in radians
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The cosine value of x in radians
* Float if input is Number or Float
* Double if input is Long or Double
@since 1.0.0
]]> Convert an angle from radians to degrees.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The angle in radians
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The angle of x in degrees
* Float if input is Number or Float
* Double if input is Long or Double
@since 1.3.0
]]> Get the arc cosine of an angle.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The cosine value
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The interval [0..PI] in radians, or +NaN+ if invalid
* Float if input is Number or Float
* Double if input is Long or Double
@since 1.0.0
]]> Compute the ceiling of a value.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

A numeric value
Returns [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The smallest integer greater than or equal to x
Return type matches the input parameter type
@since 1.3.0
]]> Convert an angle from degrees to radians.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The angle in degrees
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The angle of x in radians
* Float if input is Number or Float
* Double if input is Long or Double
@since 1.3.0
]]> Get the arc tangent of an angle.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The tangent value
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The interval [-PI/2..PI/2] in radians, or +NaN+ if invalid
* Float if input is Number or Float
* Double if input is Long or Double
@since 1.0.0
]]> Returns a pseudo-random Number. Use the {Toybox::Math#srand srand()} function to seed the random number generator.
Returns [Toybox::Lang::Number] Non-negative random number

@since 1.0.0
]]> Seed the random number generator.
seed [Toybox::Lang::Number] The value used for seeding rand()

@since 1.0.0
@note srand() does not return any value.
]]> Round a value.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

A numeric value
Returns [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The closest integer to x. Decimal values >= .5 will be rounded up
Return type matches the input parameter type
@since 1.3.0
]]> Calculate the square root of a value.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The value for which to get the square root
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The square root of x, or +NaN+ if invalid
* Float if input is Number or Float
* Double if input is Long or Double
@since 1.0.0
]]> Calculate x to the power of y.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

Base
y [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

Exponent
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

x to the power of y
* Float if both inputs are Number or Float
* Double if either input is Long or Double
@since 1.0.0
]]> Get the sine of an angle.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The angle in radians
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The sine value of x in radians
* Float if input is Number or Float
* Double if input is Long or Double
@since 1.0.0
]]> Get the arc sine of an angle.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The sine value
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The interval [-PI/2..PI/2] in radians, or +NaN+ if invalid
* Float if input is Number or Float
* Double if input is Long or Double
@since 1.0.0
]]> Compute the floor of a value.
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

A numeric value
Returns [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The largest integer less than or equal to x
Return type matches the input parameter type
@since 1.3.0
]]> Get the arc tangent of y/x in radians.
y [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The proportion of the y coordinate
x [Toybox::Lang::Number, Toybox::Lang::Float, Toybox::Lang::Long, Toybox::Lang::Double]

The proportion of the x coordinate
Returns [Toybox::Lang::Float, Toybox::Lang::Double]

The principal arc tangent of y/x, in the interval [-PI..PI] radians,
or +NaN+ if invalid
* Float if both inputs are Number or Float
* Double if either input is Long or Double
@since 1.3.0
]]> End execution of the current app.

This will exit the system cleanly from any point within an app.
@since 1.0.0
]]> Get the current millisecond timer value.
Returns [Toybox::Lang::Number]

@note The returned value typically starts at zero on device boot and
will roll over periodically. Assuming the timer starts at zero, this
will happen ~25 days after a reboot, and every ~50 days thereafter.
@since 1.0.0
]]> Write an error to the console and exit the system.
@note There are never really too many bananas.
msg [Toybox::Lang::String] The error message to output

@example
using Toybox.System;
const MAX_BANANAS = 8;
var bananasInBunch = 10;
if (bananasInBunch > MAX_BANANAS) {
System.error("Too many bananas!")
}
@since 1.0.0
]]> Get the current device settings.
Returns [Toybox::System::DeviceSettings]

@example
using Toybox.System;
var mySettings = System.getDeviceSettings();
@since 1.0.0
]]> Print to the console with a line terminator.

output [Toybox::Lang::Object] The item to print, typically a

{Toybox::Lang::String String}.
@example
using Toybox.System;
System.println("Hello Monkey C!");
@since 1.0.0
]]> Get the current system stats.
Returns [Toybox::System::Stats]

@example
using Toybox.System;
var myStats = System.getSystemStats();
@since 1.0.0
]]> Print to the console.
output [Toybox::Lang::Object] The item to print, typically a

{Toybox::Lang::String String}.
@since 1.0.0
]]> Get the current clock time.
Returns [Toybox::System::ClockTime]

@since 1.0.0
]]> Get the recommended distance above the baseline for single spaced text.

The base line is the line on which the text sits.
font [Toybox::Graphics::FontType] The font to use

Returns [Toybox::Lang::Number] The ascent of the font

@note {Toybox::Graphics::FontReference FontReference} is only supported in CIQ 4.0.0 and later
@since 1.2.0
]]> Get the height (ascent plus descent) of the given font.
font [Toybox::Graphics::FontType] The font to use

Returns [Toybox::Lang::Number] The height of the font

@note {Toybox::Graphics::FontReference FontReference} is only supported in CIQ 4.0.0 and later
@since 1.2.0
]]> Get the recommended distance below the baseline for single spaced text.

The base line is the line on which the text sits.
font [Toybox::Graphics::FontType] The font to use

Returns [Toybox::Lang::Number] The descent of the font

@note {Toybox::Graphics::FontReference FontReference} is only supported in CIQ 4.0.0 and later
@since 1.2.0
]]> Get an Array of ActivityMonitor.History objects
@since 1.0.0
Returns [Toybox::Lang::Array] An Array of

{Toybox::ActivityMonitor::History ActivityMonitor.History} objects.
* The Array will be a maximum of 7 objects
* The objects will be inserted most recent first
]]> Get the current {Toybox::ActivityMonitor::Info ActivityMonitor.Info}
@since 1.0.0
Returns [Toybox::ActivityMonitor::Info] An Info object with the

current information.
]]> Create a {Toybox::ActivityRecording::Session Session} object with
options determined by the caller.

Only one Session object is allowed to exist at a time. If there
is an existing object that has not been closed using the
{Toybox::ActivityRecording::Session#save save()} or
{Toybox::ActivityRecording::Session#discard discard()} methods, this method will
return that object instead of creating a new one. On some products
running the 1.x virtual machine, creating a Session object requires a
large memory allocation. To free this memory, the Session must first be
successfully saved or discarded, and then app references to the Session
object should be set to +null+.
@example Create a Session with auto lap detection using entry/exit lines
using Toybox.ActivityRecording;
function createSession() {
var session = ActivityRecording.createSession({ // set up recording session
:name=>"Race", // set session name
:sport=>Activity.SPORT_GENERIC, // set sport type
:subSport=>Activity.SUB_SPORT_GENERIC, // set sub sport type
:autoLap=>{ // auto lap configuration
:type=>:lines, // auto lap using entry/exit lines
:exit=>[loc1, loc2], // set exit of auto lap staging box (typically the finish line)
:entry=>[loc3, loc4], // set entrance of auto lap staging box (typically before the finish line)
:autoStart=>true // auto start using the entry/exit lines
}
});
return session;
}
options [Toybox::Lang::Dictionary] A Dictionary containing

session creation options.
@option options [Toybox::ActivityRecording::Sport, Toybox::Activity::Sport] :sport The primary sport being
recorded (SPORT_GENERIC by default).
@option options [Toybox::ActivityRecording::SubSport, Toybox::Activity::SubSport] :subSport The sport subcategory
being recorded (SUB_SPORT_GENERIC by default).
@option options [Toybox::Lang::String] :name Required. This is the name
that will be associated with the sport being recorded. The suggested
maximum length of the name is 15 characters (some devices support
longer names).
@option options [Toybox::Lang::Float] :poolLength This is the length of
the pool in meters for this activity. If this session object is configured
with +:sport=>SPORT_SWIMMING+ and +:subSport=>SUB_SPORT_LAP_SWIMMING+, this
option is required to configure the system in this mode. If it is not
provided, activity data may have undefined behavior. For all other sport
modes, this option is ignored.
@option options [Toybox::Lang::Dictionary] :autoLap A dictionary containing
auto-lap detection options. If present, this dictionary must have a +:type+ key;
If the value of +:type+ is +:lines+, the +:entry+ and +:exit+ keys are required. The
values associated with +:entry+ and +:exit+ describe the endpoints of the auto lap
entry and exit line segments, each being defined as an {Toybox::Lang::Array Array}
of two {Toybox::Position::Location Location} objects. (added in 3.0.10)
@option options [Toybox::SensorLogging::SensorLogger] :sensorLogger The
SensorLogger to use to record this session.
@throws [Toybox::Lang::InvalidOptionsException] Thrown if required options
are missing or provided options are invalid in +:autoLap+ options dictionary
Returns [Toybox::ActivityRecording::Session] A new Session object, or

the existing Session object if a Session is active and has not been
saved or discarded.
@since 1.0.0
]]> Throws an exception if value1 and value2 are equal.

The objects passed to this function must implement the
{Toybox::Lang::Object#equals Object.equals()} method which compares both
type and value.
value1 [Toybox::Lang::Object] The value to test for equality

value2 [Toybox::Lang::Object] The value to test for equality

@throws [Toybox::Test::AssertException]
@example
using Toybox.Test;
(:test)
function anAssertNotEqualTest(logger) {
var x = 1;
var y = 1;
Test.assertNotEqual(x, y);
return true;
}
// Output:
ASSERTION FAILED
Unhandled Exception
@since 2.1.0
]]> Throws an exception if the test is +false+.
test [Toybox::Lang::Boolean] The expression to test for +true+

@throws [Toybox::Test::AssertException]
@example
using Toybox.Test;
(:test)
function anAssertTest(logger) {
var x = false;
Test.assert(x);
return true;
}
// Output:
ASSERTION FAILED
Unhandled Exception
@since 2.1.0
]]> Throws an exception if value1 and value2 are equal followed by a
{Toybox::Lang::String String} defined by the developer.

The objects passed to this function must implement the
{Toybox::Lang::Object#equals Object.equals()} method which compares both
type and value.
value1 [Toybox::Lang::Object] The value to test for equality

value2 [Toybox::Lang::Object] The value to test for equality

message [Toybox::Lang::String] The identifying message for the assert

@throws [Toybox::Test::AssertException]
@example
using Toybox.Test;
(:test)
function anAssertNotEqualMessageTest(logger) {
var x = 1;
var y = 2;
Test.assertNotEqual(x, y, "x and y are equal!");
return true;
}
// Output:
ASSERTION FAILED: x and y are equal!
Unhandled Exception
@since 2.1.0
]]> Throws an exception if value1 and value2 are not equal.

The objects passed to this function must implement the
{Toybox::Lang::Object#equals Object.equals()} method which compares both
type and value.
value1 [Toybox::Lang::Object] The first value to test for

equality
value2 [Toybox::Lang::Object] The second value to test for

equality
@throws [Toybox::Test::AssertException]
@example
using Toybox.Test;
(:test)
function anAssertEqualTest(logger) {
var x = 1;
var y = 2;
Test.assertEqual(x, y);
return true;
}
// Output:
ASSERTION FAILED
Unhandled Exception
@since 2.1.0
]]> Throws an exception if value1 and value2 are not equal followed by a
{Toybox::Lang::String String} defined by the developer.

The objects passed to this function must implement the
{Toybox::Lang::Object#equals Object.equals()} method which compares both
type and value.
value1 [Toybox::Lang::Object] The value to test for equality

value2 [Toybox::Lang::Object] The value to test for equality

message [Toybox::Lang::String] The identifying message for the assert

@throws [Toybox::Test::AssertException]
@example
using Toybox.Test;
(:test)
function anAssertEqualMessageTest(logger) {
var x = 1;
var y = 2;
Test.assertEqual(x, y, "x and y are not equal!");
return true;
}
// Output:
ASSERTION FAILED: x and y are not equal!
Unhandled Exception
@since 2.1.0
]]> Throws an exception if the test is +false+ followed by a
{Toybox::Lang::String String} defined by the developer.
test [Toybox::Lang::Boolean] Expression to test for +true+

message [Toybox::Lang::String] The identifying message for the

assert
@throws [Toybox::Test::AssertException]
@example
using Toybox.Test;
(:test)
function anAssertMessageTest(logger) {
var x = false;
Test.assertMessage(x, "The assert is False for x.");
return true;
}
// Output:
ASSERTION FAILED: The assert is False for x.
Unhandled Exception
@since 2.1.0
]]> Push a View onto the View stack.
view [Toybox::WatchUi::View] View to push

delegate [Toybox::WatchUi::BehaviorDelegate,

Toybox::WatchUi::ConfirmationDelegate,
Toybox::WatchUi::InputDelegate,
Toybox::WatchUi::MenuInputDelegate,
Toybox::WatchUi::NumberPickerDelegate,
Toybox::WatchUi::PickerDelegate,
Toybox::WatchUi::TextPickerDelegate,
Toybox::WatchUi::WatchFaceDelegate]
The input delegate to handle input for the View
transition [Toybox::WatchUi::SlideType] A

{Toybox::WatchUi::SLIDE_IMMEDIATE WatchUi.SLIDE_*} value
@throws [Toybox::Lang::UnexpectedTypeException]
Thrown when view is type {Toybox::WatchUi::MapView MapView} and the
visible map area parameters are invalid
@throws [Toybox::Lang::OperationNotAllowedException] Thrown if called
from background, data field, glance, or watch face app; or if the new
view is a {Toybox::WatchUi::DataField DataField},
a {Toybox::WatchUi::GlanceView GlanceView},
or a {Toybox::WatchUi::WatchFace WatchFace}
@since 1.0.0
]]> Animate an Object.

Animate works by changing an object property over time, such as the
x-position of a Drawable. The animation starts after the call and runs
the length of the specified period. During this time, the View object's
onUpdate() method will be invoked at an increased rate to facilitate
animation.
object [Toybox::Lang::Object] The object to animate

property [Toybox::Lang::Symbol] The Symbol of the object's property

to animate (e.g. :locX, :locY, etc.)
type [Toybox::WatchUi::AnimationType] A

{Toybox::WatchUi::ANIM_TYPE_LINEAR WatchUi.ANIM_TYPE_*} value
start [Toybox::Lang::Number] The starting value of the property

stop [Toybox::Lang::Number] The ending value of the property

period [Toybox::Lang::Float] The duration of the animation in seconds

callback [Toybox::Lang::Method] A Method to call when the animation

is complete; this can be +null+
@example Move a bitmap across the screen from left to right
using System.WatchUi;

square = new Ui.Bitmap({
:rezId=>Rez.Drawables.square,
:locX=>10,
:locY=>30
});
WatchUi.animate(square, :locX, Ui.ANIM_TYPE_LINEAR, 10, 200, 10, null);
@note Will cause an app crash if called from background or data field app,
or from watch face while in low power mode
@see Toybox::WatchUi::Drawable
@see Toybox::WatchUi::Bitmap
@since 1.0.0
]]> Load a resource from the executable.

resource [Toybox::Lang::ResourceId] An identifier for a resource

defined in the project's +resources.xml+ file
Returns [Toybox::Lang::Array, Toybox::Lang::Dictionary, Toybox::Lang::String, Toybox::WatchUi::AnimationResource, Toybox::WatchUi::BitmapResource, Toybox::WatchUi::FontResource, Toybox::Graphics::BitmapReference, Toybox::Graphics::FontReference]

@note {Toybox::Graphics::BitmapReference} and {Toybox::Graphics::FontReference} are returned
for {Toybox::WatchUi::BitmapResource} and {Toybox::WatchUi::FontResource} in CIQ 4.0.0 and later.
@example Loading a String resource
// The resources.xml file contents:
//
// APEELingApp
//
using Toybox.WatchUi;

var banana = WatchUi.loadResource(Rez.Strings.AppName);
@since 1.0.0
]]> initializes the Rez module of a Barrel so static variables can be accessed during startup (global )
@since 2.4.0
]]> Pop the current View from the View stack and push a new one.

view [Toybox::WatchUi::View] The View object to push

delegate [Toybox::WatchUi::BehaviorDelegate,

Toybox::WatchUi::InputDelegate]
The input delegate to handle input for the View
transition [Toybox::WatchUi::SlideType] A

{Toybox::WatchUi::SLIDE_IMMEDIATE WatchUi.SLIDE_*} value
@throws [Toybox::Lang::OperationNotAllowedException] Thrown if called
from background, data field, glance, or watch face app; or of called
from the base page of a widget and the new view is native; or if the new
view is a {Toybox::WatchUi::DataField DataField},
a {Toybox::WatchUi::GlanceView GlanceView},
or a {Toybox::WatchUi::WatchFace WatchFace}
@note Prior to ConnectIQ 3.1, this method only supported switching to
user-defined View objects, and would only accept InputDelegate or
BehaviorDelegate objects as delegates for the given View.
@since 1.0.0
]]> initializes the Rez module so static variables can be accessed during startup (global )
@since 1.0.0
]]> Pop the current View from the View stack.
transition [Toybox::WatchUi::SlideType] A

{Toybox::WatchUi::SLIDE_IMMEDIATE WatchUi.SLIDE_*} value
@throws [Toybox::Lang::OperationNotAllowedException] Thrown if called
from background, data field, glance, or watch face app; or of called
from the base page of a widget
@since 1.0.0
]]> Request a call to the {Toybox::WatchUi::View#onUpdate onUpdate()} method
for the current View.
@see Toybox::WatchUi::View#onUpdate View.onUpdate()
@since 1.0.0
]]> @since 1.0.0
]]> Encodes a String in base64
string [Toybox::Lang::String] The string to encode

Returns [Toybox::Lang::String] A base64 encoded String

@since 1.3.0
]]> Given an Array of {Toybox::Lang::Char Char} objects, return the String equivalent
charArray [Toybox::Lang::Array] An Array of Char objects

Returns [Toybox::Lang::String] The String representation of the input Array

@since 1.3.0
]]> Given an Array of UTF-8 bytes, return the String equivalent
utf8Array [Toybox::Lang::Array] An Array of UTF-8 bytes

Returns [Toybox::Lang::String] The String representation of the input Array

@throws [Toybox::Lang::InvalidValueException] Thrown if a the provided bytes
contain an invalid UTF-8 sequence.
@since 1.3.0
]]> Retrieve the AppBase {Toybox::Lang::Object Object} that is currently
running.
Returns [Toybox::Application::AppBase] The currently running AppBase

object
@since 1.0.0
]]> Get the current Sensor {Toybox::Sensor::Info Sensor.Info}.

This is useful for retrieving the current sensor info either on demand
or periodically within a {Toybox::Timer::Timer Timer}.
Returns [Toybox::Sensor::Info]

@example Get accelerometer data once per second
using Toybox.Sensor;
using Toybox.System;
using Toybox.Timer;
var dataTimer = new Timer.Timer();
dataTimer.start(method(:timerCallback), 1000, true); // A one-second timer
function timerCallback() {
var sensorInfo = Sensor.getInfo();
if (sensorInfo has :accel && sensorInfo.accel != null) {
var accel = sensorInfo.accel;
var xAccel = accel[0];
var yAccel = accel[1];
System.println("x: " + xAccel + ", y: " + yAccel);
}
}
@see Toybox::Timer::Timer
@note Will cause an app crash if called from a data field app
@since 1.0.0
]]> Enable sensors for use.

This will enable both connected ANT+ sensors and system sensors if possible.
sensors [Toybox::Lang::Array] The sensors to enable:

* An Array of SENSOR_* types to enable
* An empty array ([]) to disable all sensors
Returns [Toybox::Lang::Array] An Array of requested sensors that are available

@example Enable a heart rate sensor
using Toybox.Sensor;
Sensor.setEnabledSensors([Sensor.SENSOR_HEARTRATE]);
@note Will cause an app crash if called from a data field app
@note Multitasking: Sensor states can not be changed while in inacitve mode
and sensor enabled during active mode will be disabled when app becomes inactive,
and re-enabled automatically when is active again.
These state changes are denoted by calls to AppBase.onActive() and AppBase.onInactive().
@since 1.0.0
]]> Request sensor events from enabled sensors.

Sensor events are retrieved from any enabled sensors at a rate of 1 Hz.
The data retrieved from enabled sensors is passed to the listener
{Toybox::Lang::Method Method} provided as a parameter to this method.
listener [Toybox::Lang::Method] A reference to a listener Method:

* Called when sensor updates are received
* Receives a Sensor.info object
* Use +null+ to specify no listener
@example
using Toybox.Sensor;
// Given an onSensor listener method is defined
Sensor.enableSensorEvents(method(:onSensor));
@note Will cause an app crash if called from a data field app
@since 1.0.0
]]> Save a location (waypoint) to the device's location list
location [Toybox::Position::Location] Location object to persist

options [Toybox::Lang::Dictionary] Dictionary of options, or +null+ to accept defaults

@option options [Toybox::Lang::String] :name Name to assign to the waypoint. If not specified will be auto-named.
@deprecated This method may be removed after System 4.
@see Toybox::PersistedContent#saveWaypoint PersistedContent.saveWaypoint()
@since 1.0.2
]]> Get a Location object's coordinates in degrees.
Returns [Toybox::Lang::Array] An Array containing the latitude and

longitude as {Toybox::Lang::Double Doubles} in a degree format
@example
using Toybox.Position;
using Toybox.System;
Position.enableLocationEvents(Position.LOCATION_ONE_SHOT, method(:onPosition));

function onPosition(info) {
var myLocation = info.position.toDegrees();
System.println(myLocation[0]); // latitude (e.g. 38.856147)
System.println(myLocation[1]); // longitude (e.g -94.800953)
}
@since 1.0.0
]]> Constructor
Create a Location based on a set of coordinates.
options [Toybox::Lang::Array] An Array of options

@option options [Toybox::Lang::Number] :latitude The latitude
@option options [Toybox::Lang::Number] :longitude The longitude
@option options [Toybox::Lang::Symbol] :format The format of the provided latitude
and longitude as one of three possible values:
* :degrees
* :radians
* :semicircles
@example
using Toybox.Position;
var myLocation = new Position.Location(
{
:latitude => 38.856147,
:longitude => -94.800953,
:format => :degrees
}
);
@since 1.0.0
]]> Get a location object's coordinates in radians.
Returns [Toybox::Lang::Array] An Array containing latitude and longitude

as {Toybox::Lang::Double Doubles} in a radian format
@example
using Toybox.Position;
using Toybox.System;
Position.enableLocationEvents(Position.LOCATION_ONE_SHOT, method(:onPosition));

function onPosition(info) {
var myLocation = info.position.toRadians();
System.println(myLocation[0]); // latitude (e.g. 0.678197)
System.println(myLocation[1]); // longitude (e.g -1.654588)
}
@since 1.0.0
]]> Get a String representation a Location object's coordinates.
format [Toybox::Position::CoordinateFormat] A Position.GEO_* value

Returns [Toybox::Lang::String] A formatted coordinate String in the

specified format
@example
using Toybox.Position;
using Toybox.System;
var myLocation = new Position.Location(
{
:latitude => 38.856147,
:longitude => -94.800953,
:format => :degrees
}
);
var locString = myLocation.toGeoString(Position.GEO_DMS); // N 38 51'22.13" W 94 45' 3.44"
@since 1.0.0
]]> See if background scanning is enabled for the channel assignment.
Returns [Toybox::Lang::Boolean] Returns +true+ if background scan is

enabled, otherwise +false+.
@example
using Toybox.Ant;
// Assuming initialized channel
ChannelAssignment.isBackgroundScanEnabled();
@since 1.2.0
]]> Constructor
By default disables background scanning.
c [Toybox::Ant::ChannelType] The channel type specifier. Must use one

of the following constants:
* {Toybox::Ant::CHANNEL_TYPE_TX_NOT_RX CHANNEL_TYPE_TX_NOT_RX} - Bidirectional Transmit (Master)
* Master Channels are not allowed on the ANT+ Network
* {Toybox::Ant::CHANNEL_TYPE_RX_NOT_TX CHANNEL_TYPE_RX_NOT_TX} - Bidirectional Receive (Slave)
* {Toybox::Ant::CHANNEL_TYPE_RX_ONLY CHANNEL_TYPE_RX_ONLY} - Receive Only (Slave)
n [Toybox::Ant::NetworkType] The network type specifier. Must use one of

the following constants:
* {Toybox::Ant::NETWORK_PUBLIC NETWORK_PUBLIC} - ANT public network
* {Toybox::Ant::NETWORK_PLUS NETWORK_PLUS} - ANT+ network
* {Toybox::Ant::NETWORK_PRIVATE NETWORK_PRIVATE} - ANT private network
* A network key must be provided for an Private Network
* Both 64 and 128 bit keys are required
@example
using Toybox.Ant;

var channelType = Ant.CHANNEL_TYPE_RX_NOT_TX // Bidirectional Receive (Slave)
var network = Ant.NETWORK_PUBLIC; // Ant public network
// Get the channel
channelAssign = new Ant.ChannelAssignment(channelType, network);

// Initialize the channel - assumes message callback method
GenericChannel.initialize(method(:onMessage), channelAssign);
@see Toybox::AntPlus
@since 1.0.0
]]> Set background scan to be enabled or disabled.

Enabling background scan can only be done on Receive Only channels.
isBackgroundScanEnabled [Toybox::Lang::Boolean] Value is

+true+ to enable background scan, otherwise +false+.
Returns [Toybox::Lang::Boolean] Return +true+ if the background scan

property was successfully set, otherwise +false+.
@example
using Toybox.Ant;
// Assuming initialized channel
ChannelAssignment.setBackgroundScan(isBackgroundScanEnabled);
@since 1.2.0
]]> Send a broadcast message.
data [Toybox::Ant::Message] A message whose payload

is an 8-byte {Toybox::Lang::Array Array} of numbers
@example
using Toybox.Ant;
// create a data Array to format Message
var data = new[8];
for (var i = 0; i < 8; i++) {
data[i] = i + 1; // Set the values of each member
}
var message = new Ant.Message();
message.setPayload(data); // Assumes valid data

// Assumes a valid GenericChannel object
genericChannel.sendBroadcast(message);
Returns [Toybox::Lang::Boolean] +true+ on success, otherwise +false+.

@see Toybox::Ant::Message
@since 1.0.0
]]> Get the current ANT channel configuration.
Returns [Toybox::Ant::DeviceConfig] The DeviceConfig object with

current channel device configuration.
@example
using Toybox.Ant;
var devConfig = genericChannel.getDeviceConfig();
// devConfig fields can now be accessed for configuration info
@see Toybox::Ant::DeviceConfig
@since 1.0.0
]]> Release the generic ANT Channel back to the system.

If the channel is open it will be automatically closed.
@example
using Toybox.Ant;

// Assumes a valid GenericChannel object
genericChannel.release();
Returns [Toybox::Lang::Boolean] +true+ on success, otherwise +false+.

@since 1.0.0
]]> Send an acknowledge message.

You can expect to receive either
{Toybox::Ant::MSG_CODE_EVENT_TRANSFER_TX_COMPLETED MSG_CODE_EVENT_TRANSFER_TX_COMPLETED} or
{Toybox::Ant::MSG_CODE_EVENT_TRANSFER_TX_FAILED MSG_CODE_EVENT_TRANSFER_TX_FAILED} if
the message succeeded/failed going to the recipient.
data [Toybox::Ant::Message] A message whose payload

is an 8-byte {Toybox::Lang::Array Array} of numbers
@example
using Toybox.Ant;
// create a data Array to format Message
var data = new[8];
for (var i = 0; i < 8; i++) {
data[i] = i + 1; // Set the values of each member
}
var message = new Ant.Message();
message.setPayload(data); // Assumes valid data

// Assumes a valid GenericChannel object
genericChannel.sendAcknowledge(message);
Returns [Toybox::Lang::Boolean] +true+ on success, otherwise +false+.

@see Toybox::Ant::Message
@since 1.0.0
]]> Constructor
listener [Toybox::Lang::Method] The Method object to call

with channel messages
channelAssignment [Toybox::Ant::ChannelAssignment] The

ChannelAssignment object for the channel
@throws [Toybox::Ant::UnableToAcquireChannelException] Thrown if the
the system does not have a channel available.
@example
using Toybox.Ant;

// Assumes a listenerCallback method and ChannelAssignment object supplied
// as parameters upon initialization
GenericChannel.initialize(method(:listenerCallback), channelAssign);
@since 1.0.0
]]> Close a generic ANT Channel.
@example
using Toybox.Ant;

// Assumes a valid GenericChannel object
genericChannel.close();
Returns [Toybox::Lang::Boolean] +true+ on success, otherwise +false+.

@since 1.0.0
]]> Set the current ANT channel configuration.
configuration [Toybox::Ant::DeviceConfig] The DeviceConfig object to

set for the current ANT channel
@example
using Toybox.Ant;
var configuration = new Ant.DeviceConfig({});

// Assumes a valid GenericChannel object
genericChannel.setDeviceConfig(configuration);
@see Toybox::Ant::DeviceConfig
Returns [Toybox::Lang::Boolean] +true+ on success, otherwise +false+.

@throws [Toybox::Lang::UnexpectedTypeError] Thrown if configuration values in configuration are not
of the correct type.
@since 1.0.0
]]> Open a generic ANT Channel.
@example
using Toybox.Ant;

// Assumes a valid GenericChannel object
genericChannel.open();
@note Multitasking: Ant channel connection can not be changed while in inacitve mode
and ant channels opened during active mode will be closed when app becomes inactive,
and re-opened automatically when is active again.
These state changes are denoted by calls to AppBase.onActive() and AppBase.onInactive().
Returns [Toybox::Lang::Boolean] +true+ on success, otherwise +false+.

@since 1.0.0
]]> Constructor
options [Toybox::Lang::Dictionary] The initialization options

@option options [Toybox::Lang::Number] :deviceNumber The ANT-id of
the device to search for. Not setting enables a wild card search
@option options [Toybox::Lang::Number] :deviceType 1-Byte device
type identifier
@option options [Toybox::Lang::Number] :transmissionType The
manufacturer-specific transport type and extended device number
@option options [Toybox::Lang::Number] :messagePeriod The message period
that the sensor uses
@option options [Toybox::Lang::Number] :radioFrequency The radio
frequency that the sensor operates on. Range of 2 to 80.
@option options [Toybox::Lang::Number] :searchTimeoutLowPriority The
Low Priority search timeout that a receiving channel will wait for
in order to start tracking a master
* Low Priority search provides the capability of searching for a master without interrupting other channels on the device
* Range of 0 to 12 (2.5s increments)
* Default 6 (15s)
@option options [Toybox::Lang::Number] :searchTimeoutHighPriority The
High Priority search timeout that a receiving channel will wait for
in order to start tracking a master
* Is triggered after the Low Priority search mode times out
* Will interrupt other channels
* Will take priority over any other open channels on that device
* If it overlaps another channel the High Priority search takes priority and that other channel is blocked
* Keeping this search type disabled unless you have great difficulty acquiring a master through Low Priority search is recommended
* High Priority searches are disabled in data-fields, and will be ignored for that application type
* Range of 0 to 2 (2.5s increments)
* Default 0 (disabled)
@option options [Toybox::Lang::Number] :searchThreshold A proximity
threshold bin as a Number
* Configures the RSSI threshold a slave channel will search for which is effectively the distance at which a slave is willing to be from a master
* Values are 0 (disabled), 1 (closest), 10 (farthest)
@option options [Toybox::Lang::Number] :networkKey64Bit 64 bit
network key
* Set this when {Toybox::Ant::NETWORK_PRIVATE NETWORK_PRIVATE} was chosen in the channel assignment
@option options [Toybox::Lang::Number] :networkKey128Bit 128 bit
network key
* Set this when NETWORK_PRIVATE was chosen in the channel assignment
@since 1.2.0
@see https://www.thisisant.com/developer/resources/downloads/ ANT Downloads & Resources - ANT Message Protocol and Usage
]]> Get the ANT data packet.
Returns [Toybox::Lang::Array] An Array of Numbers as integers

representing the bytes of the data payload
@since 1.0.0
]]> Set the ANT data packet.
data [Toybox::Lang::Array] An Array of Numbers as integers

representing the bytes of the data payload
@since 1.0.0
]]> Constructor
@since 1.2.0
]]> Constructor
dutyCycleVal [Toybox::Lang::Number] The strength of the vibration

lengthVal [Toybox::Lang::Number] The length of the vibration in milliseconds (ms)

@since 1.0.0
]]> Get the next message from the mailbox.
Returns Message content, or +null+ if no messages

@since 1.0.0
]]> Callback when a communications operation error occurs.
@since 1.0.0
]]> Callback when a communications operation completes.
@since 1.0.0
]]> Constructor
@since 1.4.0
]]> Constructor
@since 1.3.0
]]> Determine whether a key exists within a Dictionary.
key [Toybox::Lang::Object] The key to check against

Returns [Toybox::Lang::Boolean] +true+ if the key is in the Dictionary,

otherwise +false+
@since 1.0.0
]]> Retrieve the number of elements in a Dictionary.
Returns [Toybox::Lang::Number] The number of elements in the Dictionary

@since 1.0.0
]]> Retrieve the keys in the Dictionary.
Returns [Toybox::Lang::Array] An Array of keys in the Dictionary

@since 1.0.0
]]> Retrieve a value from a Dictionary for a given key.
key [Toybox::Lang::Object] The key to check against

Returns [Toybox::Lang::Object] The value for the specified key, or

+null+ if the key does not exist
@since 1.0.0
]]> Retrieve the values in the Dictionary.
Returns [Toybox::Lang::Array] An Array of values in the Dictionary

@since 1.0.0
]]> Determine whether a Dictionary is empty.
Returns [Toybox::Lang::Boolean] +true+ if the Dictionary is empty,

otherwise +false+
@since 1.0.0
]]> Convert a Dictionary to a String.

Due to the nature of hash tables, the order of Dictionary elements are
not guaranteed to match the insertion order when converting to a String.
Returns [Toybox::Lang::String] A String representation of the Dictionary

@example
using Toybox.System;
myDict = {
"One" => 1,
"Two" => 2,
"Three" => 3
};
System.println(myDict.get("One")); // prints 1

var myString = myDict.toString();
System.println(myString); // "{Two=>2, One=>1, Three=>}"
System.println(myString.get("One")); // Symbol Not Found Error
System.println(myString.substring(0, 5)); // "{Two="
@see https://en.wikipedia.org/wiki/Hash_table Hash Tables
@since 1.0.1
]]> Place a value in the Dictionary with a given key.
key [Toybox::Lang::Object] The key for the value being inserted

into the Dictionary
value [Toybox::Lang::Object] The value to insert into the Dictionary

@since 1.0.0
]]> Delete an item from a Dictionary.
key [Toybox::Lang::Object] The key of the value to be removed

@since 1.0.0
]]> Convert a Symbol to a String

This will return the string for the name of the symbol in development builds.
Because Monkey C does not contain runtime reflection information in release
builds, the returned string will be different and will follow the format "symbol (num)".
In this format, "num" is the integer value of the symbol.
Returns [String] The String representation of the Symbol

@since 1.0.0
]]> Convert a String to an Array of Char objects.
Returns [Toybox::Lang::Array] A Char Array representation of the String,

where each character in the String is an element in the Array
@since 1.3.0
]]> Convert a String to an Array of Number objects.

Each Number represents one byte of the UTF-8 representation of the String.
Returns [Toybox::Lang::Array] An Array representation of the String,

where each byte in the string is an element in the Array
@since 1.3.0
]]> Convert a String to lowercase.
Returns [Toybox::Lang::String] A new lowercase String

@since 1.0.0
]]> Convert a String to a Number using a specified base.
base [Toybox::Lang::Object] The base of the input string.

If the value of +base+ is zero, the string content expected to have
syntax similar to that of integer constants, which includes:
* An optional sign character ('+' or '-')
* An optional prefix for octal or hexadecimal ('0' or '0x')
* A sequence of digits in the prefixed base, or decimal if none was specified.
If the base value is between 2 and 36, the format expected for the
number is valid digits and/or letters that represent integers of
the specified radix (from '0' to 'z' or 'Z' for base 36).
Returns [Toybox::Lang::Number] A Number representation of the String

@example
var myString;
var myNum;

myString = "10";
myNum = myString.toNumberWithBase(2); // myNum is 2

myString = "FF";
myNum = myString.toNumberWithBase(16); // myNum is 255
myNum = myString.toNumberWithBase(0x10); // myNum is 255
@since 1.4.1
]]> Convert a String to a Float.

If a String is in the numeric form of "123" or "123.45", convert it
to a Float. Additional characters after the detected floating point
value will be ignored. Strings that cannot be interpreted as a Float,
or whose value exceeds that which can be represented in a Float, will
result in a +null+ value.
Returns [Toybox::Lang::Float] A Float representation of the String

@example
var myString;
var myNum;

myString = "123";
myNum = myString.toFloat(); // myNum is 123.000000

myString = "3.14"
myNum = myString.toFloat(); // myNum is 3.140000

myString = "192.168.0.1"
myNum = myString.toFloat(); // myNum is 192.167999

myString = "Hello There!"
myNum = myString.toFloat(); // null
@since 1.0.0
]]> Get the number of characters in a String.
Returns [Toybox::Lang::Number] The length of the String

@since 1.0.0
]]> Create a new String that contains the contents of the current String
from a start position to an end position.
@note Starting with 3.3.2, passing null for +startIndex+ sets it to the
start of the string and passing null for +endIndex+ sets it to the end
of the string. Passing in a negative number for either +startIndex+ or
+endIndex+ offsets it from the end of the string.
startIndex [Toybox::Lang::Number] Zero-based start index of

the substring
endIndex [Toybox::Lang::Number] End position of the substring,

exclusive
Returns [Toybox::Lang::String] The substring of the String or +null+

on error
@example
var myString = "Go bananas with Monkey C!";
var mySubString = myString.substring(3, 10); // mySubString is "bananas"
@since 1.0.0
]]> Get a hash code value for a String.
Returns [Toybox::Lang::Number] The hash code for the String

@since 1.0.0
]]> Determine if the specified String exists in a String.
string [Toybox::Lang::String] String to find

Returns [Toybox::Lang::Number] The index of the start of the specified

String, or +null+ if not found
@example
var myString = "Go bananas with Monkey C!";
var index = myString.find("bananas"); // index is 3
@since 1.0.0
]]> Test if an Object instance is equal to another instance of an Object.
other [Toybox::Lang::Object] The Object to test against

Returns [Toybox::Lang::Boolean] +true+ if the Objects are equal,

otherwise +false+
@since 1.0.0
]]> Convert a String to uppercase.
Returns [Toybox::Lang::String] A new uppercase String

@since 1.0.0
]]> Convert a String to a String.
Returns [Toybox::Lang::String] A String representation of String

@since 1.0.0
]]> Convert a String to a Number.

If a String is in the numeric form of "123", it can be converted to
a Number. Additional characters after the detected number value will
be ignored. Strings that cannot be interpreted as a Number, or whose
value exceeds that which can be represented in a Number, will result
in a +null+ value.
Returns [Toybox::Lang::Number] A Number representation of the String

@example
var myString;
var myNum;

myString = "123";
myNum = myString.toNumber(); // myNum is 123

myString = "3.14"
myNum = myString.toNumber(); // myNum is 3

myString = "1200 E. 151st. Street"
myNum = myString.toNumber(); // myNum is 1200

myString = "Hello There!"
myNum = myString.toNumber(); // null
@since 1.0.0
]]> Get the absolute value of a Number.
Returns [Toybox::Lang::Number] The absolute value of the Number

@since 1.0.0
]]> Convert a Number to a Double.
Returns [Toybox::Lang::Double] A Double representation of the Number

@since 1.0.0
]]> Convert a Number to a Long.
Returns [Toybox::Lang::Long] A Long representation of the Number

@since 1.0.0
]]> Convert a Number to a Float.
Returns [Toybox::Lang::Float] A Float representation of the Number

@since 1.0.0
]]> Format a Number using a formatting String.

The formatting string is similar to that available in +printf+ from the
C stdio library, though the +length+ option is not available:
"%[flags][width][.precision]specifier"
[specifiers]
* *d* or *i* - signed decimal integer
* *e* - scientific notation (mantissa/exponent) using 'e' character
* *E* - scientific notation (mantissa/exponent) using 'E' character
* *f* - decimal floating point
* *o* - signed octal
* *u* - unsigned decimal integer
* *x* - unsigned hexadecimal integer
* *X* - unsigned hexadecimal integer (capital letters)
[flags]
* + - Prepends the result with a plus or minus sign ('+' or '-'), including positive numbers. By default, only negative numbers are preceded with a '-' sign.
* *0* - Left-pads the number with zeros (0) instead of spaces, where padding is specified (see width sub-specifier).
[width]
supports only numbers (* is not supported)
[.precision]
supports only numbers (* is not supported)
Returns [Toybox::Lang::String] A formatted String

@example Formatting time with leading zeros
// Format the time to display "08:03:15"
using Toybox.Lang;
var hours = 8;
var minutes = 3;
var seconds = 15;
var myTime = Lang.format(
"$1$:$2$:$3$",
[hours.format("%02d"), minutes.format("%02d"), seconds.format("%02d")]
);
@see https://forums.garmin.com/showthread.php?255191-Formatted-Output Formatted output forum thread
@since 1.0.0
]]> Convert a Number to a Number.
Returns [Toybox::Lang::Number] A Number representation of the Number

@since 1.0.0
]]> Convert a Number to a Char.
Returns [Toybox::Lang::Char] A Char representation of the Number

@since 1.3.0
]]> Convert a Char to lowercase.
Returns [Toybox::Lang::Char] A new lowercase Char

@since 1.3.0
]]> Convert a Char to uppercase.
Returns [Toybox::Lang::Char] A new uppercase Char

@since 1.3.0
]]> Convert a Char to a String.
Returns [Toybox::Lang::String] The String representation of the Char

@since 1.3.0
]]> Convert a Char to a Number.
Returns [Toybox::Lang::Number] The UTF-32 representation of the Char

interpreted as a Number
@since 1.3.0
]]> Get the Object referenced by the WeakReference
Returns [Toybox::Lang::Object] The Object referenced, or +null+ if

the Object no longer exists
@since 1.2.0
]]> Determine whether a WeakReference is still alive.
Returns [Toybox::Lang::Boolean] +true+ if object is still alive,

otherwise +false+
@note I feel FANTASTIC and I am still alive. When you're dying I'll
be still alive. And when you're dead I will be still alive.
@see http://knowyourmeme.com/memes/still-alive-portal-end-theme
@since 1.2.0
]]> Get a hash code value for a Method.
This computes a 32-bit Number that is typically used as an index when
placing Objects into a Dictionary. Hash code values have the following
characteristics:
* The computed hash code is constant for the lifetime of an Object
* If two Objects are equal, their hash codes will be equal
Returns [Toybox::Lang::Number] A hash code for the Method

@see https://en.wikipedia.org/wiki/Hash_function Hash Function
@see https://en.wikipedia.org/wiki/Hash_table Hash Tables
@since 1.0.0
]]> Invoke a Method.
parameters... [Toybox::Lang::Object] The parameters required by

the invoked Method
Returns [Toybox::Lang::Object] The return value from the invoked Method

@since 1.0.0
]]> Method Constructor.
aClass Classdef of method (e.g. Toybox.SensorHistory) or

a class instance.
aMethod [Toybox::Lang::Symbol] Symbol of class method

@since 1.0.0
]]> Get the absolute value of a Double.
Returns [Toybox::Lang::Double] The absolute value of the Double

@since 1.0.0
]]> Convert a Double to a Double.
Returns [Toybox::Lang::Double] A Double representation of the Double

@since 1.0.0
]]> Convert a Double to a Long.
Returns [Toybox::Lang::Long] A Long representation of the Double

@since 1.0.0
]]> Test if an Object instance is equal to another instance of an Object.
other [Toybox::Lang::Object] The Object to test against

Returns [Toybox::Lang::Boolean] +true+ if the Objects are equal,

otherwise +false+
@since 1.3.0
]]> Convert a Double to a Float.
Returns [Toybox::Lang::Float] A Float representation of the Double

@since 1.0.0
]]> Format a Double using a formatting String.

The formatting string is similar to that available in +printf+ from the
C stdio library, though the +length+ option is not available:
"%[flags][width][.precision]specifier"
[specifiers]
* *d* or *i* - signed decimal integer
* *e* - scientific notation (mantissa/exponent) using 'e' character
* *E* - scientific notation (mantissa/exponent) using 'E' character
* *f* - decimal floating point
* *o* - signed octal
* *u* - unsigned decimal integer
* *x* - unsigned hexadecimal integer
* *X* - unsigned hexadecimal integer (capital letters)
[flags]
* + - Prepends the result with a plus or minus sign ('+' or '-'), including positive numbers. By default, only negative numbers are preceded with a '-' sign.
* *0* - Left-pads the number with zeros (0) instead of spaces, where padding is specified (see width sub-specifier).
[width]
supports only numbers (* is not supported)
[.precision]
supports only numbers (* is not supported)
Returns [Toybox::Lang::String] A formatted String

@since 1.0.0
]]> Convert a Double to a String.
Returns [Toybox::Lang::String] The String representation of the Double

@since 1.0.0
]]> Convert a Double to a Number.

The Double value will be rounded toward 0 upon conversion. For example,
6.8 becomes 6 and -5.7 becomes -5.
Returns [Toybox::Lang::Number] A Number representation of the Double

@since 1.0.0
]]> Print the stack trace of the thrown Exception.
@since 1.1.2
]]> Exception constructor.
@since 1.1.2
]]> Get the error message for the Exception.
Returns [Toybox::Lang::String] The Exception's error message, or +null+

if no message is given
@since 1.2.0
]]> Add an Object to the end of an Array.

When adding an Object, the Array size is increased by one and the new
Object is inserted at the new index.
object [Toybox::Lang::Object] The Object to be added to the Array

Returns [Toybox::Lang::Array] self

@since 1.3.0
]]> Remove Objects from an Array.

For each instance of the Object that is found, the Array size is
decreased by one and elements beyond it are shifted to the next lower
index.
object [Toybox::Lang::Object] The Object to be removed from

the Array
Returns [Toybox::Lang::Boolean] +true+ if instances of the Object are

found, otherwise +false+
@since 1.3.0
]]> Get the size of an Array.
Returns [Toybox::Lang::Number] The number of elements in the Array

@since 1.0.0
]]> Add an Array of Objects to the end of an Array.

When adding an Array of Objects, the Array is expanded by the size of
the provided Array, and all of the new elements are inserted starting
at the new index.
array [Toybox::Lang::Array] The Array of Objects to be added

to the Array
Returns [Toybox::Lang::Array] self

@since 1.3.0
]]> Get a new Array containing a portion of an existing Array.
startIndex [Toybox::Lang::Number, null] A zero-based index of the

start of the new Array. If a negative +startIndex+ is provided, it
will offset from the end of the Array. If the +startIndex+ is +null+,
the slice will begin at 0. An out-of-bounds index will be truncated
to the array limits.
endIndex [Toybox::Lang::Number, null] A zero-based index of the end

of the new Array. Items are included up to, but not including +endIndex+.
If a negative +endIndex+ is provided, it will offset from the end of
the Array. If +endIndex+ is +null+, the the slice will end at the last
element. An out-of-bounds index will be truncated to the Array limits.
Returns [Toybox::Lang::Array] A new Array containing the elements from

+startIndex+ to +endIndex+
@example
var myArray = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];

// Get the first five elements of the Array
var newArray1 = myArray.slice(0, 5); // [1, 2, 3, 4, 5]

// Get the last element of the Array
var newArray2 = myArray.slice(-1, null); // [10]

// Slice off the first and last elements from the Array
var myArray3 = myArray.slice(1, -1); // [2, 3, 4, 5, 6, 7, 8, 9]
@since 1.3.0
]]> Convert an Array to a String.

This does not convert the elements of the Array into Strings, but
transforms the entire Array into a String.
Returns [Toybox::Lang::String] A String representation of the Array

@example
using Toybox.System;
var myArray = [1, 2, 3, 4, 5];
System.println(myArray[1]); // prints 1

var myString = myArray.toString();
System.println(myString); // "[1, 2, 3, 4, 5]"
System.println(myString[1]); // UnexpectedTypeException
System.println(myString.substring(0, 5)); // "[1, 2"
@since 1.0.0
]]> Return a new Array that contains the elements of a source Array in
reverse order.
Returns [Toybox::Lang::Array] A new Array with elements in reversed order

@since 1.3.0
]]> Get the index of an Object within the Array.
object [Toybox::Lang::Object] The Object whose index is to be found

Returns [Toybox::Lang::Number] The index of the first instance of the provided

Object in the Array. If the Object is not found, -1 is returned.
@since 1.3.0
]]> Remove an Object from an Array.

If the passed Object is found, the Array size is decreased by one and
elements beyond it are shifted to the next lower index. If the Array
has multiple matches, the matching Object at the lowest index will be
removed but the other matching Objects will not be removed.
object [Toybox::Lang::Object] The object to be removed from

the Array
Returns [Toybox::Lang::Boolean] +true+ if instances of the object are

found, otherwise +false+
@since 1.3.0
]]> Get the absolute value of a Float.
Returns [Toybox::Lang::Float] The absolute value of the Float

@since 1.0.0
]]> Convert a Float to a Double.
Returns [Toybox::Lang::Double] A Double representation of the Float

@since 1.0.0
]]> Convert a Float to a Long.
Returns [Toybox::Lang::Long] A Long representation of the Float

@since 1.0.0
]]> Convert a Float to a Float.
Returns [Toybox::Lang::Float] A Float representation of the Float

@since 1.0.0
]]> Format a Float using a formatting String.

The formatting string is similar to that available in +printf+ from the
C stdio library, though the +length+ option is not available:
"%[flags][width][.precision]specifier"
[specifiers]
* *d* or *i* - signed decimal integer
* *e* - scientific notation (mantissa/exponent) using 'e' character
* *E* - scientific notation (mantissa/exponent) using 'E' character
* *f* - decimal floating point
* *o* - signed octal
* *u* - unsigned decimal integer
* *x* - unsigned hexadecimal integer
* *X* - unsigned hexadecimal integer (capital letters)
[flags]
* + - Prepends the result with a plus or minus sign ('+' or '-'), including positive numbers. By default, only negative numbers are preceded with a '-' sign.
* *0* - Left-pads the number with zeros (0) instead of spaces, where padding is specified (see width sub-specifier).
[width]
supports only numbers (* is not supported)
[.precision]
supports only numbers (* is not supported)
Returns [Toybox::Lang::String] A formatted String

@since 1.0.0
]]> Convert a Float to a Number.

The Float value will be rounded toward 0 upon conversion. For example,
6.8 becomes 6 and -5.7 becomes -5.
Returns [Toybox::Lang::Number] A Number representation of the Float

@since 1.0.0
]]> Convert a ResourceId to a String

Returns [Toybox::Lang::String] The String representation of the ResourceId

@since 1.0.0
]]> Get the absolute value of a Long.
Returns [Toybox::Lang::Long] The absolute value of the Long

@since 1.0.0
]]> Convert a Long to a Double.
Returns [Toybox::Lang::Double] A Double representation of the Long

@since 1.0.0
]]> Convert a Long to a Long.
Returns [Toybox::Lang::Long] A Long representation of the Long

@since 1.0.0
]]> Test if an Object instance is equal to another instance of an Object.
other [Toybox::Lang::Object] The Object to test against

Returns [Toybox::Lang::Boolean] +true+ if the Objects are equal,

otherwise +false+
@since 1.3.0
]]> Convert a Long to a Float.
Returns [Toybox::Lang::Float] A Float representation of the Long

@since 1.0.0
]]> Format a Long using a formatting String.

The formatting string is similar to that available in +printf+ from the
C stdio library, though the +length+ option is not available:
"%[flags][width][.precision]specifier"
[specifiers]
* *d* or *i* - signed decimal integer
* *e* - scientific notation (mantissa/exponent) using 'e' character
* *E* - scientific notation (mantissa/exponent) using 'E' character
* *f* - decimal floating point
* *o* - signed octal
* *u* - unsigned decimal integer
* *x* - unsigned hexadecimal integer
* *X* - unsigned hexadecimal integer (capital letters)
[flags]
* + - Prepends the result with a plus or minus sign ('+' or '-'), including positive numbers. By default, only negative numbers are preceded with a '-' sign.
* *0* - Left-pads the number with zeros (0) instead of spaces, where padding is specified (see width sub-specifier).
[width]
supports only numbers (* is not supported)
[.precision]
supports only numbers (* is not supported)
Returns [Toybox::Lang::String] A formatted String

@since 1.0.0
]]> Convert a Long to a String.
Returns [Toybox::Lang::String] A String representation of the Long

@since 1.0.0
]]> Convert a Long to a Number.
Returns [Toybox::Lang::Number] A Number representation of the Long

@since 1.0.0
]]> Retrieve a callback to a Method.

This is typically used when supplying a callback function to another method.
methodName [Toybox::Lang::Symbol] The Symbol of the specified Method

Returns [Toybox::Lang::Method] A Method object for the specified Symbol

@see Toybox::Lang::Method
@since 1.0.0
]]> Get a hash code value for an Object.

This computes a 32-bit Number that is typically used as an index when
placing Objects into a Dictionary. Hash code values have the following
characteristics:
* The computed hash code is constant for the lifetime of an Object
* If two Objects are equal, their hash codes will be equal
Returns [Toybox::Lang::Number] A hash code for the Object

@see https://en.wikipedia.org/wiki/Hash_function Hash Function
@see https://en.wikipedia.org/wiki/Hash_table Hash Tables
@since 1.0.0
]]> Test if an Object instance is equal to another instance of an Object.
other [Toybox::Lang::Object] The Object to test against

Returns [Toybox::Lang::Boolean] +true+ if Objects are equal, otherwise

+false+
@example
var a = 1;
var b = 1;
var c = 1.0;
a.equals(b); // returns true
a.equals(c); // returns false
@since 1.0.0
]]> Convert an Object to a String.
Returns [Toybox::Lang::String] A String representation of the Object

@example
var myNumber = 3219;
var myString = myNumber.toString();
@since 1.0.0
]]> Get a WeakReference to an Object.

A weak reference is an object that keeps a reference to an object but
does not increment the reference count. This means the object reference
can be destroyed, so is a case that should be handled.
@note Immutable types (Number, Float, Long, Double, Boolean, String)
will return their values. Other Object types will return a WeakReference
object.
Returns [Toybox::Lang::WeakReference] A WeakReference to the Object

@see Toybox::Lang::WeakReference
@since 1.2.0
]]> UnexpectedTypeException constructor.
msg [Toybox::Lang::String] The exception message

unused1 [Toybox::Lang::Object] Unused. Preserves argument count for compatibility

unused2 [Toybox::Lang::Object] Unused. Preserves argument count for compatibility

@since 1.2.0
]]> Add a {Toybox::Time::Duration Duration} to a Moment.

This method functions the same as the {Toybox::Time::Duration#add Duration.add()}
method when adding a Duration to a Moment.
duration [Toybox::Time::Duration] The Duration to add to this

Moment
Returns [Toybox::Time::Moment] A Moment object that is the sum of self

and the provided Duration object
@example Add one day to today
using Toybox.Time;
using Toybox.Time.Gregorian;
var today = new Time.Moment(Time.today().value());
var oneDay = new Time.Duration(Gregorian.SECONDS_PER_DAY);
var tomorrow = today.add(oneDay);
@see Toybox::Time::Duration#add Duration.add()
@see Toybox::Time::Gregorian::SECONDS_PER_DAY SECONDS_PER_DAY
@since 1.0.0
]]> Determine if a Moment is before or after another Moment.

This computes a Number representing the difference between the two
Moment objects in seconds. The {Toybox::Time::Moment#subtract subtract()}
method can also be used to get the absolute Duration between two Moment
objects.
moment [Toybox::Time::Moment] The Moment to compare to this

Moment
Returns [Toybox::Lang::Number] The Number of seconds difference between

the two Moment objects. If the Moment supplied for comparison is after
this Moment, the value will be negative.
@example
using Toybox.System;
using Toybox.Time;
using Toybox.Time.Gregorian;
var today = new Time.Moment(Time.today().value());
var oneDay = new Time.Duration(Gregorian.SECONDS_PER_DAY);
var tomorrow = today.add(oneDay);

System.println(today.compare(tomorrow)); // -86400, or one day in the past
System.println(tomorrow.compare(today)); // 86400, or one day in the future
@see Toybox::Time::Moment#subtract Moment.subtract()
@see Toybox::Time::Gregorian::SECONDS_PER_DAY SECONDS_PER_DAY
@since 1.0.0
]]> Subtract a {Toybox::Time::Duration Duration} or
{Toybox::Time::Moment Moment} from a Moment.

subtrahend [Toybox::Time::Moment, Toybox::Time::Duration] The

Moment or Duration to subtract from this Moment
Returns [Toybox::Time::Duration, Toybox::Time::Moment] The Duration

between the two Moment objects or the Moment offset by a Duration.

When subtracting Moments, the computed Duration is always a positive
value. The {Toybox::Time::Moment#compare compare()} method can be
used to determine whether one Moment is before or after another Moment.
@note Subtracting a Duration from a Moment was not supported until
ConnectIQ 3.0.0. If backward compatibility is a concern, it may be
best to add a negative Duration instead.
@example
using Toybox.System;
using Toybox.Time;
using Toybox.Time.Gregorian;
var today = new Time.Moment(Time.today().value());
var oneDay = new Time.Duration(Gregorian.SECONDS_PER_DAY);
var tomorrow = today.add(oneDay);

var duration1 = today.subtract(tomorrow);
var duration2 = tomorrow.subtract(today);

System.println(duration1.value()); // 86400, or one day
System.println(duration2.value()); // 86400, or one day
@see Toybox::Time::Moment#compare Moment.compare()
@see Toybox::Time::Gregorian::SECONDS_PER_DAY SECONDS_PER_DAY
@since 1.0.0
]]> Determine if a Moment is less than another Moment.
moment [Toybox::Time::Moment] The Moment to compare to this

Moment
Returns [Toybox::Lang::Boolean] +true+ if this Moment is less than the

Moment supplied for comparison, otherwise +false+
@example
using Toybox.System;
using Toybox.Time;
using Toybox.Time.Gregorian;
var today = new Time.Moment(Time.today().value());
var oneDay = new Time.Duration(Gregorian.SECONDS_PER_DAY);
var tomorrow = today.add(oneDay);

System.println(today.lessThan(tomorrow)); // true
System.println(tomorrow.lessThan(today)); // false
@see Toybox::Time::Gregorian::SECONDS_PER_DAY SECONDS_PER_DAY
@since 1.0.0
]]> Constructor
seconds [Toybox::Lang::Number] The Number of seconds with which

to initialize the Moment
Returns [Toybox::Time::Moment] A Moment representing the specified moment

in time
@example Create a Moment with a UNIX time stamp
using Toybox.Time;
var garminFounded = new Time.Moment(631065600);
@example Create a Moment representing today
using Toybox.Time;
var today = new Time.Moment(Time.today().value());
@see https://en.wikipedia.org/wiki/Coordinated_Universal_Time UTC Time
@see https://en.wikipedia.org/wiki/Unix_time UNIX Time
@since 1.1.2
]]> Get the UTC value of a Moment.
Returns [Toybox::Lang::Number] The UTC date of the Moment in seconds

since the UNIX epoch
@see https://en.wikipedia.org/wiki/Coordinated_Universal_Time UTC Time
@see https://en.wikipedia.org/wiki/Unix_time UNIX Time
@since 1.0.0
]]> Determine if a Moment is greater than another Moment.
moment [Toybox::Time::Moment] The Moment to compare to this

Moment
Returns [Toybox::Lang::Boolean] +true+ if this Moment is greater than

the Moment supplied for comparison, otherwise +false+
@example
using Toybox.System;
using Toybox.Time;
using Toybox.Time.Gregorian;
var today = new Time.Moment(Time.today().value());
var oneDay = new Time.Duration(Gregorian.SECONDS_PER_DAY);
var tomorrow = today.add(oneDay);

System.println(today.greaterThan(tomorrow)); // false
System.println(tomorrow.greaterThan(today)); // true
@see Toybox::Time::Gregorian::SECONDS_PER_DAY SECONDS_PER_DAY
@since 1.0.0
]]> Add a {Toybox::Time::Moment Moment} or another Duration to a Duration.

When adding a Moment to a Duration, this method functions the same as
the {Toybox::Time::Moment#add Moment.add()} method.
time [Toybox::Time::Duration, Toybox::Time::Moment] The Duration

or Moment to add to Duration
Returns [Toybox::Time::Duration, Toybox::Time::Moment] A Duration or

Moment object that is the sum of self and the provided object:
* Duration + Moment = Moment
* Duration + Duration = Duration
@example Add two Duration objects
using Toybox.Time;
var oneHour = new Time.Duration(3600);
var twoHours = new Time.Duration(7200);
var threeHours = oneHour.add(twoHours);
@see Toybox::Time::Moment#add Moment.add()
@since 1.0.0
]]> Determine if a Duration is shorter or longer than another Duration.

This computes a Number representing the difference between the two
Duration objects in seconds. The {Toybox::Time::Duration#subtract subtract()}
method can also be used to get the absolute difference between two
Duration objects.
duration [Toybox::Time::Duration] The Duration to compare to

this Duration
Returns [Toybox::Lang::Number] The Number of seconds difference between

the two Duration objects. If the Duration supplied for comparison is
longer than this Duration, the value will be negative.
@example
using Toybox.System;
using Toybox.Time;
var oneHour = new Time.Duration(3600);
var twoHours = new Time.Duration(7200);

System.println(oneHour.compare(twoHours)); // -3600, or one minute in the past
System.println(twoHours.compare(oneHour)); // 3600, or one minute in the future
@since 1.0.0
]]> Get the absolute difference between two Duration objects.

The computed Duration is always a positive value. The
{Toybox::Time::Duration#compare compare()} method can also be used to
get the difference between two Duration objects.
duration [Toybox::Time::Duration] The Duration to subtract from

this Duration
Returns [Toybox::Time::Duration] The difference between the two

Duration objects
@example
using Toybox.Time;
var twoHours = new Time.Duration(7200);
var threeHours = new Time.Duration(10800);
var oneHour = threeHours.subtract(twoHours);
@since 1.0.0
]]> Determine if a Duration is shorter than another Duration.
duration [Toybox::Time::Duration] The Duration to compare to

this Duration
Returns [Toybox::Lang::Boolean] +true+ if this Duration is shorter than

the Duration supplied for comparison, otherwise +false+
@example
using Toybox.System;
using Toybox.Time;
var oneHour = new Time.Duration(3600);
var twoHours = new Time.Duration(7200);

System.println(oneHour.lessThan(twoHours)); // true
System.println(twoHours.lessThan(oneHour)); // false
@since 1.0.0
]]> Divide a Duration by a value.
value [Toybox::Lang::Number, Toybox::Lang::Float] The value by

which to divide the Duration
Returns [Toybox::Time::Duration] The quotient of the Duration and the

supplied value
@example
using Toybox.Time;
var fourHours = new Time.Duration(Gregorian.SECONDS_PER_HOUR * 4);
var twoHours = fourHours.divide(2);
@since 1.0.0
]]> Constructor
value [Toybox::Lang::Number] The Number of seconds with which

to initialize the Duration
Returns [Toybox::Time::Duration] A Duration representing the specified

Number of seconds
@example Create a Duration of one day with a number of seconds
using Toybox.Time;
var oneDay = new Time.Duration(86400);
@see Toybox::Time::Gregorian#duration Gregorian.duration()
@since 1.0.0
]]> Multiply a Duration by a value.
value [Toybox::Lang::Number, Toybox::Lang::Float] The value

by which to multiply the Duration
Returns [Toybox::Time::Duration] The product of the Duration and the

supplied value
@example
using Toybox.Time;
var twoHours = new Time.Duration(7200);
var fourHours = twoHours.multiply(2);
@since 1.0.0
]]> Get the value of a Duration.
Returns [Toybox::Lang::Number] The value of the Duration in seconds

@since 1.0.0
]]> Determine if a Duration is longer than another Duration.
duration [Toybox::Time::Duration] The Duration to compare to

this Duration
Returns [Toybox::Lang::Boolean] +true+ if this Duration is longer than

the Duration supplied for comparison, otherwise +false+
@example
using Toybox.System;
using Toybox.Time;
var oneHour = new Time.Duration(3600);
var twoHours = new Time.Duration(7200);

System.println(oneHour.greaterThan(twoHours)); // false
System.println(twoHours.greaterThan(oneHour)); // true
@since 1.0.0
]]> Create a {Toybox::Time::Duration Duration} from a Dictionary of options.

This is an alternative to
{Toybox::Time::Duration#initialize Duration.initialize()} that allows
the Duration to be made more easily, using familiar units, which can
be handy when building a Duration manually.

Option values are represented as signed 32-bit integers.
options [Toybox::Lang::Dictionary] A dictionary of options

@option options [Toybox::Lang::Number] :years The number of years
(max 69)
@option options [Toybox::Lang::Number] :days The number of days
(max 24855)
@option options [Toybox::Lang::Number] :hours The number of hours
(max 596523)
@option options [Toybox::Lang::Number] :minutes The number of minutes
(max 35791394)
@option options [Toybox::Lang::Number] :seconds The number of seconds
(max 2147483647)
Returns [Toybox::Time::Duration] The Duration representing the

specified span of time
@example Create a Duration of one day with Gregorian.duration()
using Toybox.Time.Gregorian;
var oneDay = Gregorian.duration({:days => 1});
@see Toybox::Time::Duration#initialize Duration.initialize()
@since 1.0.0
]]> Parameterized version of Moment.
year [Toybox::Lang::Number] An int representing the number of years

month [Toybox::Lang::Number] An int representing the number of months

day [Toybox::Lang::Number] An int representing the number of days

hour [Toybox::Lang::Number] An int representing the number of hours

minute [Toybox::Lang::Number] An int representing the number of minute

second [Toybox::Lang::Number] An int representing the number of seconds

Returns [Toybox::Time::Moment] A Moment object of the given date

@since 1.0.0
]]> Return a Gregorian.MONTH_* given a month symbol
@since 1.0.0
]]> Create a {Toybox::Time::Moment Moment} from a Dictionary of options.
Each option value is assumed to be in the UTC time zone.

Unlike {Toybox::Time::Moment#initialize Moment.initialize()}, which
is based on the UNIX epoch, a Moment created with Gregorian.moment()
is based on {Toybox::Time#today today()}. The result is determined
by taking the result of {Toybox::Time#today today()} and overlaying
the options provided.

options [Toybox::Lang::Dictionary] A dictionary of options;

values that would not result in a valid date are not allowed
@option options [Toybox::Lang::Number] :year The year (1970-2106)
@option options [Toybox::Lang::Number, Toybox::Lang::Symbol] :month The month (1-12) or a Symbol (:january, :february, ...)
@option options [Toybox::Lang::Number] :day The day of month (1-31)
@option options [Toybox::Lang::Number] :hour The hour (0-23)
@option options [Toybox::Lang::Number] :minute The minute (0-59)
@option options [Toybox::Lang::Number] :second The second (0-59)
Returns [Toybox::Time::Moment] A Moment representing the specified

moment in time
@example Create a Moment representing midnight on the first day of the current month.
using Toybox.Time;
var oneDay = Gregorian.moment({:day => 1});
@see Toybox::Time::Moment#initialize Moment.initialize()
@see https://en.wikipedia.org/wiki/Coordinated_Universal_Time UTC Time
@since 1.0.0
]]> Get {Toybox::Time::Gregorian::Info Info} for a {Toybox::Time::Moment Moment}
in local time.
moment [Toybox::Time::Moment, Toybox::Time::LocalMoment] A Moment

or LocalMoment object for which to get Info
format [Toybox::Time::DateFormat] A Time.FORMAT_* type

Returns [Toybox::Time::Gregorian::Info] Info for the supplied Moment

formatted according to the specified format type in local time.
@example Get Info for today in local time (assume CST)
using Toybox.System;
using Toybox.Time;
using Toybox.Time.Gregorian;
var options = {
:year => 2003,
:month => 5, // 3.x devices can also use :month => Gregorian.MONTH_MAY
:day => 16,
:hour => 0
};
var date = Gregorian.moment(options);
var birthday = Gregorian.info(date, Time.FORMAT_MEDIUM);
System.println(birthday.year); // 2003
System.println(birthday.month); // May
System.println(birthday.day); // 16
System.println(birthday.hour); // 19
@since 1.0.0
]]> Fill an ellipse with the foreground color.
x [Toybox::Lang::Numeric] The x location of the ellipse center

y [Toybox::Lang::Numeric] The y location of the ellipse center

a [Toybox::Lang::Numeric] The radius of the ellipse along the

x axis
b [Toybox::Lang::Numeric] The radius of the ellipse along the

y axis
@since 1.0.0
]]> Draw a point on the screen.
x [Toybox::Lang::Numeric] The x location of the point

y [Toybox::Lang::Numeric] The y location of the point

@since 1.0.0
]]> Fill a rounded rectangle with the foreground color.
x [Toybox::Lang::Numeric] The x location of the upper corner

y [Toybox::Lang::Numeric] The y location of the upper corner

width [Toybox::Lang::Numeric] The width value of the rectangle

height [Toybox::Lang::Numeric] The height value of the

rectangle
radius [Toybox::Lang::Numeric] The radius of the rounding

@since 1.0.0
]]> Get the width of the display region that is available to the app.
Returns [Toybox::Lang::Number] The width of display in pixels

@since 1.0.0
]]> Draw a bitmap to the screen.
x [Toybox::Lang::Numeric] The top left x coordinate to begin

the draw
y [Toybox::Lang::Numeric] The top left y coordinate to begin

the draw
bitmap [Toybox::WatchUi::BitmapResource, Toybox::Graphics::BufferedBitmap, Toybox::Graphics::BitmapReference] The object to draw.

The source color palette must be a subset of the destination color
palette.
@throws [Toybox::Graphics::InvalidPaletteException] Thrown if the
source color palette is not a subset of the destination palette
@note {Toybox::Graphics::BitmapReference BitmapReference} is only supported in CIQ 4.0.0 and later
@since 1.0.0
]]> Get the height of the display region that is available to the app.
Returns [Toybox::Lang::Number] The height of display in pixels

@since 1.0.0
]]> Fill a polygon with the foreground color.
pts [Toybox::Lang::Array] Array of coordinates with a 64

point limit
@since 1.0.0
]]> Draw a rectangle.
x [Toybox::Lang::Numeric] The x location of the upper corner

y [Toybox::Lang::Numeric] The y location of the upper corner

width [Toybox::Lang::Numeric] The width value of the rectangle

height [Toybox::Lang::Numeric] The height value of the

rectangle
@since 1.0.0
]]> Draw a rounded rectangle.
x [Toybox::Lang::Numeric] The x location of the upper corner

y [Toybox::Lang::Numeric] The y location of the upper corner

width [Toybox::Lang::Numeric] The width value of the rectangle

height [Toybox::Lang::Numeric] The height value of the

rectangle
radius [Toybox::Lang::Numeric] The radius of the rounding.

@since 1.0.0
]]> Draw an ellipse around a point.
x [Toybox::Lang::Numeric] The x location of the ellipse center

y [Toybox::Lang::Numeric] The y location of the ellipse center

a [Toybox::Lang::Number] The radius of the ellipse along the

x axis
b [Toybox::Lang::Number] The radius of the ellipse along the

y axis
@since 1.0.0
]]> Get the width and height of a String.

This takes new lines into account when determining the height.
The width is the maximum width for a given line of the String. If a
String has two newline characters (\\n) in it, the height would be
for three lines and the width would be the width of the longest
String.
text [Toybox::Lang::String] The text to get the width for

font [Toybox::Graphics::FontType] The font of the text to measure.

Returns [Toybox::Lang::Array] The [width, height] of the String in pixels

@since 1.0.0
]]> Draw a circle around a point.
x [Toybox::Lang::Numeric] The x location of the circle center

y [Toybox::Lang::Numeric] The y location of the circle center

radius [Toybox::Lang::Number] The radius of the circle

@since 1.0.0
]]> Draw text at the given location.

This method is not supported for anti-aliased fonts
(including most built in fonts) for a
{Toybox::Graphics::BufferedBitmap BufferedBitmap} that has a
palette.
x [Toybox::Lang::Numeric] The x location of the text

y [Toybox::Lang::Numeric] The y location of the text

font [Toybox::Graphics::FontType] The font to use.

This can be a custom font loaded from resources or a Graphics.FONT_* value.
text [Toybox::Lang::Object] The Object to render.

justification Mask of Graphics.TEXT_JUSTIFY_* constants. This

may either be a single Graphics.TEXT_JUSTIFY_* constant, or a combination
of one vertical and one horizontal justification value as a bit mask
(e.g., Graphics.TEXT_JUSTIFY_CENTER | Graphics.TEXT_JUSTIFY_VCENTER).
@throws [Toybox::Graphics::InvalidPaletteException] Thrown if an
anti-aliased font is used on a paletted bitmap
@note {Toybox::Graphics::FontReference FontReference} is only supported in CIQ 4.0.0 and later
@since 1.0.0
]]> Erase the screen using the background color.

@note Starting form version 3.1.0, COLOR_TRANSPARENT will also be
honored as background color, which will cause the value of pixels
in the clip region to be replaced by COLOR_TRANSPARENT. For
example, this can be used to clear the transparent overlay layer
so animation background is visible.
@since 1.0.0
]]> Draw a line between two points.
x1 [Toybox::Lang::Numeric] The first x coordinate

y1 [Toybox::Lang::Numeric] The first y coordinate

x2 [Toybox::Lang::Numeric] The second x coordinate

y2 [Toybox::Lang::Numeric] The second y coordinate

@since 1.0.0
]]> Draw an arc.
* 0 degrees: 3 o'clock position.
* 90 degrees: 12 o'clock position.
* 180 degrees: 9 o'clock position.
* 270 degrees: 6 o'clock position.
x [Toybox::Lang::Numeric] The x location of the arc center

y [Toybox::Lang::Numeric] The y location of the arc center

r [Toybox::Lang::Numeric] The radius of the arc

attr [Toybox::Graphics::ArcDirection] Arc drawing attributes.

(ARC_COUNTER_CLOCKWISE or ARC_CLOCKWISE)
degreeStart [Toybox::Lang::Numeric] The start angle of the arc

by degrees.
degreeEnd [Toybox::Lang::Numeric] The end angle of the arc by

degrees.
@since 1.2.0
]]> Get the height of a font.
font [Toybox::Graphics::FontType] The font to measure

Returns [Toybox::Lang::Number] The height of the font in pixels

@since 1.0.0
]]> Get the width of a String.
text [Toybox::Lang::String] The text to get width for

font [Toybox::Graphics::FontType] The font of the text to measure.

Returns [Toybox::Lang::Number] The width of String in pixels

@since 1.0.0
]]> Set the current foreground and background colors.
foreground [Toybox::Graphics::ColorType] Graphics.COLOR_* constant

or 24-bit integer of the form 0xRRGGBB.
background [Toybox::Graphics::ColorType] Graphics.COLOR_* constant

or 24-bit integer of the form 0xRRGGBB.
@since 1.0.0
]]> Set the width of a line.
width [Toybox::Lang::Numeric] The pen width in pixels

@since 1.0.0
]]> Fill a circle with the foreground color.
x [Toybox::Lang::Numeric] The x location of the circle center

y [Toybox::Lang::Numeric] The y location of the circle center

radius [Toybox::Lang::Numeric] The radius of the circle

@since 1.0.0
]]> Fill a rectangle with the foreground color.
x [Toybox::Lang::Numeric] The x location of the upper corner

y [Toybox::Lang::Numeric] The y location of the upper corner

width [Toybox::Lang::Numeric] The width value of the rectangle

height [Toybox::Lang::Numeric] The height value of the

rectangle
@since 1.0.0
]]> Complete the Session by discarding the recorded data.
Returns [Toybox::Lang::Boolean] +true+ if the Session was

successfully discarded, otherwise +false+
@since 1.0.0
]]> Begin recording a FIT file on the system.
Returns [Toybox::Lang::Boolean] +true+ if recording was successfully

started, otherwise +false+
@since 1.0.0
]]> Complete the session by storing the FIT file on the file system.
Returns [Toybox::Lang::Boolean] +true+ if the session was

successfully saved, otherwise +false+
@since 1.0.0
]]> Get a GeometryIterator for the Session.

Call get() to retrieve the Location. Use next() to iterate to the next point. It is
important that the geometryIterator doesn't persist as this locks
down the ActivityRecording. Use it to iterate the points and then
let it go. If there are no points, +null+ is returned.
Returns [Toybox::ActivityRecording::GeometryIterator] A geometry iterator for the

Session or +null+
@since 1.0.0
@deprecated This class may be removed after System 3.
]]> Add a lap to the current recording.
Returns [Toybox::Lang::Boolean] +true+ if a lap was successfully

created, otherwise +false+
@since 1.0.0
]]> Create a new {Toybox::FitContributor::Field Field}.

Field objects allow developers to store information in FIT developer
fields. This information can be displayed in Garmin Connect as a
per-second graph, as lap information, or as workout summary
information.
name [Toybox::Lang::String] The name of the Field as a String

* The maximum length may vary between products
* At least 64 bytes are available
fieldId [Toybox::Lang::Number] The unique Field Identifier

for the Field
type [Toybox::FitContributor::DataType] The type definition for the Field

from the DATA_TYPE_* enumerator in the
{Toybox::FitContributor FitContributor} module
options [Toybox::Lang::Dictionary] Optional parameters that

can be specified for Field creation
@option options [Toybox::Lang::Number] :count The number
of elements to add to the Field if it is an Array
* This is also the maximum combined size of strings plus +null+ terminators if the type is DATA_TYPE_STRING (Default 1)
* Apps are limited to 256 total bytes per message
* Data fields are limited to 32 bytes per message
* Messages larger than the limit will result in a "New Field out of memory for FIT data" error.
@option options [Toybox::Lang::Number] :mesgType The
message type that this Field should be added to
* Defaults to {Toybox::FitContributor::MESG_TYPE_RECORD MESG_TYPE_RECORD} if not provided
* If mesgType == {Toybox::FitContributor::MESG_TYPE_RECORD MESG_TYPE_RECORD}, {Toybox::FitContributor::DATA_TYPE_STRING DATA_TYPE_STRING} cannot be used as the Field type.
@option options [Toybox::Lang::String] :units The display
units as a String
* This should use the current device language
* The maximum length may vary between products
* At least 16 bytes are available
@option options [Toybox::Lang::Number] :nativeNum If this
Field can be treated equivalently to a Field that is included in
the FIT SDK use this to indicate the Field Number that is specified
by the FIT Profile.
Returns [Toybox::FitContributor::Field] The resulting Field object

@see https://www.thisisant.com/resources/fit The Message type
descriptions can be found in Profile.xlsx included in the FIT SDK
@see Toybox::FitContributor::Field FitContributor.Field
@see https://developer.garmin.com/connect-iq/core-topics/activity-recording/ Core Topics - Activity Recording
@since 1.3.0
]]> Check if recording is active for this Session.
Returns [Toybox::Lang::Boolean] +true+ if recording is active,

otherwise +false+
@since 1.0.0
]]> Stop recording a FIT file on the system.
Returns [Toybox::Lang::Boolean] +true+ if recording was successfully

stopped, otherwise +false+
@since 1.0.0
]]> There is no public constructor; Session objects must be created with
createSession().
]]> Stops the Timer from running.

This only needs to be called for repeating timers. A Timer can be
started again by calling start().
@since 1.0.0
]]> Start the Timer.
callback [Toybox::Lang::Method] A function to call after the

Timer completes
time [Toybox::Lang::Number] The number of milliseconds to

wait before invoking callback
repeat [Toybox::Lang::Boolean] Set to +true+ to have the Timer

repeat until stop() is called
@note Will cause an app crash if called from a watch face app while
in low power mode
@since 1.0.0
]]> Constructor
message [Toybox::Lang::String] The exception message

@since 2.1.0
]]> Must return a {Toybox::Lang::Number Number} indicating the number
of tests to run
@since 2.1.0
]]> Runs the indicated test.

The parameter can be any type. Must return
+true+ on pass and +false+ on failure.
@since 2.1.0
]]> Write a debug {Toybox::Lang::String String} to the output stream.

The String is prefixed with DEBUG and a time stamp.
str [Toybox::Lang::String] The String output to the console

@example
using Toybox.Test;
(:test)
function aDebugTest(logger) {
logger.debug("This is a debug message.");
return true;
}
// Output:
DEBUG (9:23): This is a debug message.
@since 2.1.0
]]> Write a warning {Toybox::Lang::String String} to the output stream.

The String is prefixed with WARNING and a time stamp.
str [Toybox::Lang::String] The String output to the console

@example
using Toybox.Test;
(:test)
function aWarningTest(logger) {
logger.warning("This is a warning message.");
return true;
}
// Output:
WARNING (9:23): This is a warning message.
@since 2.1.0
]]> Write an error {Toybox::Lang::String String} to the output stream.

The String is prefixed with ERROR and time stamp.
str [Toybox::Lang::String] The String output to the console

@example
using Toybox.Test;
(:test)
function anErrorTest(logger) {
logger.error("This is an error message.");
return true;
}
// Output:
ERROR (9:24): This is an error message.
@since 2.1.0
]]> Get the type of click event.
Returns [Toybox::WatchUi::ClickType] A

{Toybox::WatchUi::CLICK_TYPE_TAP WatchUi.CLICK_TYPE_*} value
@since 1.0.0
]]> Constructor
x [Toybox::Lang::Number] The x-coordinate of the click event

y [Toybox::Lang::Number] The y-coordinate of the click event

type [Toybox::WatchUi::ClickType] The

{Toybox::WatchUi::CLICK_TYPE_TAP WatchUi.CLICK_TYPE_*} value for
this event
@since 1.0.0
]]> Get the coordinates of a click event.
Returns [Toybox::Lang::Array] An array containing the x and y

coordinates of the click event as {Toybox::Lang::Number Numbers}
@since 1.0.0
]]> The device is exiting low power mode.

Timers and animations may be started here in preparation for once-per-second
updates.
@see Toybox::WatchUi::WatchFace
@since 1.0.0
]]> The device is entering low power mode.

Terminate any active timers and prepare for once-per-minute updates.
@see Toybox::WatchUi::WatchFace
@since 1.0.0
]]> Constructor
@since 1.0.0
]]> Return value for an item.
item [Toybox::Lang::Number] The item index

Returns [Toybox::Lang::Object] The item's value

@since 1.2.0
]]> Generate a Drawable instance for an item.
item [Toybox::Lang::Number] The item index

isSelected [Toybox::Lang::Boolean] +true+ if the current item

is the selected item, otherwise +false+
Returns [Toybox::WatchUi::Drawable] The Drawable object to render

@since 1.2.0
]]> Get the number of items in the PickerFactory.
Returns [Toybox::Lang::Number]

@since 1.2.0
]]> Set the size of a Drawable object.
w [Toybox::Lang::Number] The width of the Drawable object

h [Toybox::Lang::Number] The height of the Drawable object

@since 1.0.0
]]> Set the on-screen location for a Drawable object.
x [Toybox::Lang::Number] The horizontal position on the screen

y [Toybox::Lang::Number] The vertical position on the screen

@since 1.0.0
]]> Constructor
options [Toybox::Lang::Dictionary] A Dictionary containing

options for the Drawable object
@option options [Toybox::Lang::Object] :identifier The identifier
for the Drawable object
@option options [Toybox::Lang::Number] :locX The absolute, on-screen
x-coordinate for the Drawable object
@option options [Toybox::Lang::Number] :locY The absolute, on-screen
y-coordinate for the Drawable object
@option options [Toybox::Lang::Number] :width The clip width of the
Drawable object
@option options [Toybox::Lang::Number] :height The clip height of
the Drawable object
@option options [Toybox::Lang::Boolean] :visible The visibility of
the Drawable object
@note The option +:visible+ is only supported with ConnectIQ 3.3.0
and later.
@since 1.0.0
]]> Draw an object to the device context ({Toybox::Graphics::Dc Dc}).

This method assumes that the device context has already been
configured to the proper options.

Derived classes should check the isVisible property, if it exists,
before trying to draw.

dc [Toybox::Graphics::Dc] The device context

@since 1.0.0
]]> Handle a cancel event from a Picker
@since 1.2.0
]]> Handle a confirm event from a Picker
values [Toybox::Lang::Array] The values chosen in the Picker.

@note A +null+ value will be returned for any
{Toybox::WatchUi::Drawable Drawable} entries
@since 1.2.0
]]> A lap event has occurred.

This method is called when a lap is added to the current activity.
A notification is triggered after the lap record has been written to
the FIT file.
@since 1.3.0
]]> Get the current Data Field background color.

Some devices provide a global Data Field background color setting.
This method will return the current value of that setting as a value
of either {Toybox::Graphics::COLOR_WHITE Graphics.COLOR_WHITE}
or {Toybox::Graphics::COLOR_BLACK Graphics.COLOR_BLACK}.
Returns [Toybox::Graphics::ColorType] A

{Toybox::Graphics::COLOR_WHITE Graphics.COLOR_*} value
@see Toybox::Graphics
@since 1.2.0
]]> The activity timer has started.

This method is called when the activity timer goes from a stopped
state to a started state. If the activity timer is running when the
app is loaded, this event will run immediately after startup.
@since 1.3.0
]]> Get the screen regions that are obscured.

Non-rectangular screens have certain portions of the screen obscured.
For example, a round screen effectively cuts off the corners of a
square screen. This method returns a sum of the enumerated values
defined by the WatchUi.DataField.OBSCURE_* constants that match the
obscured screen regions on the device. Use of this method is only
valid during the call to {Toybox::WatchUi::View#onUpdate onUpdate()}.
Returns [Toybox::WatchUi::DataField::Obscurity] A

{Toybox::WatchUi::DataField::OBSCURE_LEFT WatchUi.DataField.OBSCURE_*}
value
@since 1.0.0
]]> The current activity has ended.

This method is called when the time has stopped and current activity
is ended.
@since 1.3.0
]]> Retrieve {Toybox::Activity::Info Activity.Info} in a DataField.

This method is called once per second and automatically provides
{Toybox::Activity::Info Activity.Info} to the DataField object for
display or additional computation. It is necessary to override
+compute()+ when implementing a DataField.
info [Toybox::Activity::Info] The updated Activity.Info object

@example
function compute(info) {
if (info has :currentHeartRate) {
if (info.currentHeartRate != null) {
hrValue = info.currentHeartRate;
} else {
hrValue = 0.0f;
}
}
}
@see Toybox::Activity::Info Activity.Info
@since 1.0.0
]]> Create a new custom FIT {Toybox::FitContributor::Field Field}.

To record custom activity data to a FIT file, a new
{Toybox::FitContributor::Field Field} must first be created to allow
Data Fields access to FIT recording without allowing access to the
session. Once created, a Field is updated in the FIT file by changing
the *value* of the data within the Field.
name [Toybox::Lang::String] The name of the Field

fieldId [Toybox::Lang::Number] The unique Field identifier of

the Field
type [Toybox::FitContributor::DataType] A

{Toybox::FitContributor::DATA_TYPE_SINT8 FitContributor.DATA_TYPE_*}
value representing the type definition of the Field
options [Toybox::Lang::Dictionary] Optional parameters for

field creation
@option options [Toybox::Lang::Number] :count The number of elements
to add to the field if it is an Array. This is also the maximum
combined size of the Strings plus their +null+ terminators if the Field
type is FitContributor.DATA_TYPE_STRING (Default 1).
@option options [Toybox::FitContributor::MessageType] :mesgType Optional. A
{Toybox::FitContributor::MESG_TYPE_SESSION FitContributor.MESG_TYPE_*}
value representing the Field message type.
This defaults to FitContributor.MESG_TYPE_RECORD if not specified.
Additionally, if FitContributor.MESG_TYPE_RECORD is used, the field
type cannot be FitContributor.DATA_TYPE_STRING.
@option options [Toybox::Lang::String] :units Optional. A String
representing the display units (e.g. "mph", "ft", "Pa")
Returns [Toybox::FitContributor::Field]

@see Toybox::FitContributor
@see https://www.thisisant.com/resources/fit The Messages Sheet in
Profile.xlsx included with the FIT SDK for native field numbers
@since 1.3.0
]]> The activity time has resumed.

This method is called when the activity timer goes from a paused state
to a running state.
@since 1.3.0
]]> The activity timer is paused.

This method is called when the activity timer goes from a running
state to a paused state. The paused state occurs when the auto-pause
feature pauses the timer. If the activity timer is paused when the
app is loaded, this event will run immediately after startup.
@since 1.3.0
]]> Constructor
@since 1.0.0
]]> The activity timer has stopped.

This method is called when the activity timer goes from a running
state to a stopped state.
@since 1.3.0
]]> Constructor
initialText [Toybox::Lang::String] The initial text for the

TextPicker
@since 1.1.0
]]> A touch screen hold event has occurred.

This is sent when the touch screen is touched and not released.
clickEvent [Toybox::WatchUi::ClickEvent] The click event that

has occurred
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@see Toybox::WatchUi::ClickEvent
@since 1.0.0
]]> Maps low level events to delegate events.
@note DO NOT OVERRIDE.
@todo This should be a hidden function, but +TVM_obj_invoke()+ only
looks at public functions
@since 1.0.0
]]> A physical button has been released.

To find out which key was pressed, use
{Toybox::WatchUi::KeyEvent#getKey KeyEvent.getKey()} to get the button's
{Toybox::WatchUi::KEY_POWER WatchUi.KEY_*} enum value.
keyEvent [Toybox::WatchUi::KeyEvent] The key event that occurred

Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@see Toybox::WatchUi::KeyEvent
@since 1.1.2
]]> A touch screen swipe event has occurred.

This is sent when the touch screen is swiped.
swipeEvent [Toybox::WatchUi::SwipeEvent] The swipe event that

has occurred
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@see Toybox::WatchUi::SwipeEvent
@since 1.0.0
]]> A screen tap event has occurred.

This is sent when the touch screen is tapped (a quick touch and release).
clickEvent [Toybox::WatchUi::ClickEvent] The click event that

occurred
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@see Toybox::WatchUi::ClickEvent
@since 1.0.0
]]> A physical button has been pressed and released.

To find out which key was pressed, use
{Toybox::WatchUi::KeyEvent#getKey KeyEvent.getKey()} to get the button's
{Toybox::WatchUi::KEY_POWER WatchUi.KEY_*} enum value.
keyEvent [Toybox::WatchUi::KeyEvent] The key event that occurred

Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@see Toybox::WatchUi::KeyEvent
@since 1.0.0
]]> A physical button has been pressed down.

To find out which key was pressed, use
{Toybox::WatchUi::KeyEvent#getKey KeyEvent.getKey()} to get the button's
{Toybox::WatchUi::KEY_POWER WatchUi.KEY_*} enum value.
keyEvent [Toybox::WatchUi::KeyEvent] The key event that occurred.

Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@see Toybox::WatchUi::KeyEvent
@since 1.1.2
]]> A touch screen release event has occurred.

This is only sent after an {Toybox::WatchUi::InputDelegate#onHold onHold()}
event, once the hold on the touch screen is released.
clickEvent [Toybox::WatchUi::ClickEvent] The click event that

has occurred
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@see Toybox::WatchUi::ClickEvent
@since 1.0.0
]]> Add an entry to a Menu.
label [Toybox::Lang::String, Toybox::Lang::ResourceId] The item text as a String or string ResourceId

identifier [Toybox::Lang::Symbol] A Symbol representing the Menu item

value
@since 1.0.0
]]> Set a Menu title.
title [Toybox::Lang::String, Toybox::Lang::ResourceId] The title text or a string ResourceId

@since 1.0.0
]]> Set the value of the ProgressBar.
progressValue [Toybox::Lang::Float] The current value of the

ProgressBar:
* An increment from 0 to 100
* +null+ for "busy"
@since 1.0.0
]]> Constructor
displayString [Toybox::Lang::String] The string to display on

the ProgressBar
startValue [Toybox::Lang::Float] The initial value for the

ProgressBar:
* An increment from 0 to 100
* +null+ for "busy"
@since 1.0.0
]]> Set the string to display on the ProgressBar.
displayString [Toybox::Lang::String] The string to display on

the ProgressBar
@since 1.0.0
]]> Get the height of a bitmap resource.
Returns [Toybox::Lang::Number] Height of the bitmap in pixels

@since 1.0.0
]]> Get info about a bitmap resource as a String.

The info String is formatted as "Bitmap X x Y" where "X" is the width
of the bitmap and "Y" is the height.
Returns [Toybox::Lang::String] A String representation of the

BitmapResource object
@since 1.0.0
]]> Get the width of a bitmap resource.
Returns [Toybox::Lang::Number] Width of the bitmap in pixels

@since 1.0.0
]]> Set the color of a Text object.
color [Toybox::Graphics::ColorType] A

{Toybox::Graphics::COLOR_WHITE Graphics.COLOR_*} value
representing the desired text color
@since 1.0.0
]]> Set the background color of a Text object.
color [Toybox::Graphics::ColorType] A

{Toybox::Graphics::COLOR_WHITE Graphics.COLOR_*} value
representing the desired background color
@since 1.3.0
]]> Constructor
options [Toybox::Lang::Dictionary] A Dictionary containing

the options for the Text object
@option options [Toybox::Lang::String, Toybox::Lang::ResourceId] :text
The text string or ResourceId of a string resource
@option options [Toybox::Graphics::ColorType] :color A
{Toybox::Graphics::COLOR_WHITE Graphics.COLOR_*} value representing
the desired text color, defaults to COLOR_WHITE
@option options [Toybox::Graphics::ColorType] :backgroundColor
A {Toybox::Graphics::COLOR_WHITE Graphics.COLOR_*} value representing
the desired background color, defaults to COLOR_TRANSPARENT
@option options [Toybox::Graphics::FontType] :font A
value representing the desired font face, defaults to FONT_MEDIUM
@option options [Toybox::Graphics::TextJustification, Toybox::Lang::Number] :justification
A {Toybox::Graphics::TEXT_JUSTIFY_RIGHT Graphics.TEXT_JUSTIFY_*} value
representing the desired justification, defaults to TEXT_JUSTIFY_LEFT
@see Toybox::WatchUi::Drawable#initialize Drawable.initialize()
@since 1.0.0
]]> Draw Text to the device context ({Toybox::Graphics::Dc Dc}).
dc [Toybox::Graphics::Dc] The device context

@since 1.0.0
]]> Set the font face of a Text object.
font [Toybox::Graphics::FontDefinition] A

{Toybox::Graphics::FONT_XTINY Graphics.FONT_*} value representing
the desired font face or a resource object from
{Toybox::WatchUi#loadResource WatchUi.loadResource()}
@see Toybox::WatchUi#loadResource WatchUi.loadResource()
@since 1.0.0
]]> Set the justification of a Text object.
justification [Toybox::Graphics::TextJustification] A

{Toybox::Graphics::TEXT_JUSTIFY_RIGHT Graphics.TEXT_JUSTIFY_*}
value representing the desired justification
@since 1.0.0
]]> Set the text string of a Text object.
text [Toybox::Lang::String, Toybox::Lang::ResourceId] The text

String or a string ResourceId
@since 1.0.0
]]> A Menu item was chosen.

This method is called when a Menu item has been selected, and receives
the Menu item as an argument.
item [Toybox::Lang::Symbol] The identifier of the chosen Menu

item
@since 1.0.0
]]> A confirmation selection was made.

This method is called when a {Toybox::WatchUi::Confirmation Confirmation}
response is selected, and receives the response as an argument. The
response is either a {Toybox::WatchUi::CONFIRM_NO CONFIRM_NO} or
{Toybox::WatchUi::CONFIRM_YES CONFIRM_YES} value.
response [Toybox::WatchUi::Confirm] The

{Toybox::WatchUi::CONFIRM_NO WatchUi.CONFIRM_*} value from this
Confirmation
@see Toybox::WatchUi::Confirmation
@since 1.0.0
]]> Represents the _Previous_ _Page_ behavior.

This is typically triggered by the up button
({Toybox::WatchUi::KEY_UP KEY_UP})) or by a
{Toybox::WatchUi::SWIPE_DOWN SWIPE_DOWN}
{Toybox::WatchUi::SwipeEvent SwipeEvent} on a touch screen.
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@since 1.0.0
]]> Represents the _Menu_ behavior.

This is typically triggered by the menu button
({Toybox::WatchUi::KEY_MENU KEY_MENU}).
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@since 1.0.0
]]> This maps low level events to delegate events.
@note DO NOT OVERRIDE.
@todo Make this hidden once TVM_obj_invoke() is reworked
@since 1.0.0
]]> Represents the _Next_ behavior.
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@since 1.0.0
]]> Represents the _Selection_ behavior.

This is typically triggered by the Start/Enter button
({Toybox::WatchUi::KEY_ENTER KEY_ENTER}) or by a
{Toybox::WatchUi::CLICK_TYPE_TAP CLICK_TYPE_TAP}
{Toybox::WatchUi::ClickEvent ClickEvent} on a touch screen.
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@since 1.2.0
]]> Represents the _Back_ behavior.

This is typically triggered by the back button
({Toybox::WatchUi::KEY_ESC KEY_ESC}).
@note Some devices interpret {Toybox::WatchUi::SWIPE_RIGHT SWIPE_RIGHT}
{Toybox::WatchUi::SwipeEvent SwipeEvents} as {Toybox::WatchUi::KEY_ESC KEY_ESC}
events. On these devices, returning +false+ will cause
{Toybox::WatchUi::InputDelegate#onKey onKey()} to be called
rather than {Toybox::WatchUi::InputDelegate#onSwipe onSwipe()}.
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@since 1.0.0
]]> Constructor
@since 1.0.0
]]> Represents the _Next_ _Page_ behavior.

This is typically triggered by the down button
({Toybox::WatchUi::KEY_DOWN KEY_DOWN}) or by a
{Toybox::WatchUi::SWIPE_UP SWIPE_UP}
{Toybox::WatchUi::SwipeEvent SwipeEvent} on a touch screen.
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@since 1.0.0
]]> Represents the _Previous_ _Mode_ behavior.
Returns [Toybox::Lang::Boolean] +true+ if handled, otherwise +false+

@since 1.0.0
]]> Constructor
mode [Toybox::Lang::Number] The

{Toybox::WatchUi::NUMBER_PICKER_DISTANCE NUMBER_PICKER_*} value for
the desired mode
initialValue [Toybox::Lang::Number, Toybox::Lang::Float,

Toybox::Time::Duration] The initial value for the NumberPicker,
dependent on the specified mode
@since 1.0.0
]]> Get the direction of the swipe.
Returns [Toybox::WatchUi::SwipeDirection] A

{Toybox::WatchUi::SWIPE_UP WatchUi.SWIPE_*} value
@since 1.0.0
]]> Constructor
direction [Toybox::WatchUi::SwipeDirection] The

{Toybox::WatchUi::SWIPE_UP WatchUi.SWIPE_*} value for
this event
@since 1.0.0
]]> Constructor
message [Toybox::Lang::String] The confirmation message to

display in the confirmation dialog
@since 1.0.0
]]> Retrieve {Toybox::Activity::Info Activity.Info} in a SimpleDataField.

This method is called once per second and automatically provides
{Toybox::Activity::Info Activity.Info} to the SimpleDataField object
for display or additional computation. It is necessary to override
+compute()+ when implementing a SimpleDataField. The value to be
displayed in the field must be returned by this method.
info [Toybox::Activity::Info] The updated Activity.Info object

Returns [Toybox::Lang::Number, Toybox::Lang::Long, Toybox::Lang::Float,

Toybox::Lang::Double, Toybox::Time::Duration, Toybox::Lang::String, null]
The value to be displayed in the field or +null+
@example
function compute(info) {
return info.currentHeartRate;
}
@see Toybox::Activity::Info Activity.Info
@since 1.0.0
]]> Constructor
@since 1.0.0
]]> A text string was entered into a TextPicker.

This method is called when text has been specified by a TextPicker,
and receives the text String as an argument.
text [Toybox::Lang::String] The entered text

changed [Toybox::Lang::Boolean] The entered text differs from

the initially specified text of the TextPicker
@since 1.1.0
]]> Text entry has been canceled.
@since 1.1.0
]]> Get the key value of this event.
Returns [Toybox::WatchUi::Key] A

{Toybox::WatchUi::KEY_POWER WatchUi.KEY_*} value
@since 1.0.0
]]> Get the type of click event.
Returns [Toybox::WatchUi::KeyPressType] A

{Toybox::WatchUi::PRESS_TYPE_DOWN WatchUi.PRESS_TYPE_*} value
@since 1.1.2
]]> Constructor
keyValue [Toybox::WatchUi::Key] A

{Toybox::WatchUi::KEY_POWER WatchUi.KEY_*} value
keyPressType [Toybox::WatchUi::KeyPressType] A

{Toybox::WatchUi::PRESS_TYPE_DOWN WatchUi.PRESS_TYPE_*}
value for the event (since 1.1.2)
@since 1.0.0
]]> Get the dimensions of a Bitmap.
Returns [Toybox::Lang::Array] A two element array containing the

width and height of the Bitmap object
@since 1.0.0
]]> Set the resource associated with the Bitmap.

bitmap [Toybox::Graphics::BitmapType, Toybox::Lang::ResourceId] The ResourceId or

the Bitmap object.
@throws [Toybox::Lang::UnexpectedTypeException] Thrown if bitmap is not a valid type
@note A +null+ value passed for the bitmap parameter is only
supported with ConnectIQ 5.0.0 and later.
@since 1.0.0
]]> Constructor
options [Toybox::Lang::Dictionary] A Dictionary containing

the options for the Bitmap object
@option options [Toybox::Lang::ResourceId] :rezId The resource
identifier for the Bitmap object
@option options [Toybox::Graphics::BitmapType] :bitmap The BitmapResource,
BufferedBitmap, BitmapReference, or BufferedBitmapReference object to use
@see Toybox::WatchUi::Drawable#initialize Drawable.initialize()
@since 1.0.0
]]> Draw a Bitmap to the device context ({Toybox::Graphics::Dc Dc}).
dc [Toybox::Graphics::Dc] The device context

@since 1.0.0
]]> Set the options for the Picker.
options [Toybox::Lang::Dictionary] A Dictionary containing

the options for the Picker object
@option options [Toybox::WatchUi::Drawable] :title The title for the
Picker (required)
@option options [Toybox::Lang::Array] :pattern An Array of either
{Toybox::WatchUi::Drawable Drawable} or
{Toybox::WatchUi::PickerFactory PickerFactory} objects for the Picker
to display. A PickerFactory presents a choice of
Pickers, while a Drawable immediately displays the Picker (required)
@option options [Toybox::Lang::Array] :defaults An Array of
{Toybox::Lang::Number Number} objects indicating the starting index
for each entry in the supplied pattern (optional)
@option options [Toybox::WatchUi::Drawable] :nextArrow A custom next
icon for the Picker (optional)
@option options [Toybox::WatchUi::Drawable] :previousArrow A custom
previous icon for the Picker (optional)
@option options [Toybox::WatchUi::Drawable] :confirm A custom
confirmation icon for the Picker (optional)
@see Toybox::WatchUi::PickerFactory
@see Toybox::WatchUi::Drawable
@since 1.2.0
]]> Constructor
options [Toybox::Lang::Dictionary] A Dictionary containing

the options for the Picker object
@see Toybox::WatchUi::Picker#setOptions Picker.setOptions()
@since 1.2.0
]]> Show the View.

This is called when the View is brought into the foreground. Resources
should be loaded into system memory for use in the View at this point.
@since 1.0.0
]]> The entry point for the View.

onLayout() is called before the View is shown to load resources and
set up the layout of the View.
dc [Toybox::Graphics::Dc] The device context

@since 1.0.0
]]> Find a Drawable by its ID.

A common use for this method is to get layout information to format
dynamic content, such as a string that updates at runtime.
identifier [Toybox::Lang::Object] The identifier of the Drawable to find

Returns [Toybox::WatchUi::Drawable] A Drawable if found, otherwise

+null+
@example Formatting the clock time as centered, blue text
// The layout.xml file contents:
//
//

using Toybox.Graphics;
using Toybox.Lang;
using Toybox.System;
using Toybox.WatchUi.View;

var clockTime = System.getClockTime();
var timeString = Lang.format(
"$1$:$2$",
[clockTime.hour, clockTime.min.format("%02d")]
);
var view = View.findDrawableById("TimeLabel");
view.setText(timeString);
@see Toybox::System#getClockTime System.getClockTime()
@since 1.0.0
]]> Hide the View.

This is called before the View is removed from the foreground. This
occurs when a new View object is pushed on top of the current one,
when the current View is popped, or when the app is closed. Resources
should be freed from memory at this point if the current View will be
left on the page stack.
@since 1.0.0
]]> Set the layout for the View.

Set the array of Drawable objects to be managed by this View. The
specified Drawables will be:
* Drawn automatically via calls to {Toybox::WatchUi::View#onUpdate onUpdate()}
* Searched via calls to {Toybox::WatchUi::View#findDrawableById findDrawableById()}
layout [Toybox::Lang::Array] An array of Drawables or +null+.

@since 1.0.0
]]> Update the View.

This is called when a View is brought to the foreground, after the
call to {Toybox::WatchUi::View#onShow onShow()}. While a View is
active, this method is generally used to update dynamic content in
the View. There are also some special cases when it will be invoked:
* On {Toybox::WatchUi#requestUpdate WatchUi.requestUpdate()} calls within Widgets and Watch Apps
* Once per minute in Watch Faces when in low power mode
* Once per second in Watch Faces when in high power mode
* Once per second in Data Fields
* At an increased rate while an {Toybox::WatchUi#animate animation} is active
* More than one call to onUpdate() may occur during View transitions
If a class that extends View does not implement this function then any
Drawable objects contained in the View will automatically be drawn.
dc [Toybox::Graphics::Dc] The device context

@see Toybox::WatchUi::WatchFace#onPartialUpdate WatchFace.onPartialUpdate()
@since 1.0.0
]]> Iterate over all the layouts and draw them in dc
]]> A number was entered in a NumberPicker.

This method is called when a number has been specified by a
NumberPicker, and receives the numeric value as an argument.
value [Toybox::Lang::Number, Toybox::Lang::Float,

Toybox::Time::Duration] The entered number (type dependent upon the
NumberPicker mode)
@since 1.0.0
]]> Set the value to write to this Field.
input [Toybox::Lang::Object] The data to be written to the Field

@throws [Toybox::Lang::UnexpectedTypeException] Thrown if the +input+
type does not match the type specified in
{Toybox::ActivityRecording::Session#createField createField()} at
definition
@since 1.3.0
]]> There is no public constructor; Field objects must be created with
createField().
]]> Validate a property being stored.

key [Toybox::Application::PropertyKeyType] The key to validate

value [Toybox::Application::PropertyValueType] The value to validate

@since 1.0.0
]]> Get the data associated with a given key from the object store.

Properties must first be set with
{Application::AppBase#setProperty setProperty()} before they are
can be obtained with +getProperty+.
@note Symbols can change from build to build and are not to be used
for for Keys or Values.
key [Toybox::Application::PropertyKeyType] The key of the value to retrieve

from the object store (cannot be a Symbol)
Returns [Toybox::Application::PropertyValueType] The content associated with the key,

or +null+ if the key is not in the object store
@see Toybox::Application::AppBase#setProperty setProperty()
@see Toybox::Background
@see Toybox::Application::Properties
@see Toybox::Application::Storage
@since 1.0.0
@deprecated This method may be removed after System 4.
]]> Clear the object store for the application.
@note Background processes cannot clear properties.
@throws [Toybox::Application::ObjectStoreAccessException] Thrown if called
from a background process
@see Toybox::Application::Storage
@since 1.0.0
@deprecated This method may be removed after System 4.
@see Toybox::Application::Properties
@see Toybox::Application::Storage
]]> Override to provide the initial View and Input Delegate of the application.

@note This method must be overridden in derived classes. If called, this
function will cause the application to crash.
Returns [Toybox::Lang::Array] An Array containing a

{Toybox::WatchUi::View WatchUi.View} and an optional
{Toybox::WatchUi::BehaviorDelegate WatchUi.BehaviorDelegate},
{Toybox::WatchUi::ConfirmationDelegate WatchUi.ConfirmationDelegate},
{Toybox::WatchUi::InputDelegate WatchUi.InputDelegate},
{Toybox::WatchUi::MenuInputDelegate WatchUi.MenuInputDelegate},
{Toybox::WatchUi::NumberPickerDelegate WatchUi.NumberPickerDelegate},
{Toybox::WatchUi::PickerDelegate WatchUi.PickerDelegate},
{Toybox::WatchUi::TextPickerDelegate WatchUi.TextPickerDelegate}, or
{Toybox::WatchUi::WatchFaceDelegate WatchUi.WatchFaceDelegate}
@since 1.0.0
]]> Override to provide a {Toybox::WatchUi::View WatchUi.View} for a goal that
has triggered within a watch face.

* If a goal is reached when a watch face is running, this function will be triggered.
* The type of goal that was met will be provided, and the AppBase should return a View that displays a goal reached message and/or animations for that goal.
* If a View is returned from this function, the main watch face view will be shutdown, and then new View will pushed.
* If this method is not overridden in the AppBase, or if it returns +null+, the native goal screens will be shown.
goalType [Toybox::Application::GoalType] The goal type that has triggered.

The goalType will be from the GOAL_TYPE_* enumeration.

Returns [Toybox::Lang::Array] An Array containing a {Toybox::WatchUi::View WatchUi.View}

@since 1.3.0
]]> Delete the given key from the object store.
@note Background processes cannot delete properties.
key [Toybox::Application::PropertyKeyType] The key to delete

@throws [Toybox::Application::ObjectStoreAccessException] Thrown
if called from a background process
@see Toybox::Application::Storage
@since 1.0.0
@deprecated This method may be removed after System 4.
@see Toybox::Application::Properties
@see Toybox::Application::Storage
]]> Method called at startup to allow handling of app initialization.

Before the initial {Toybox::WatchUi::View WatchUi.View} is retrieved,
onStart() is called. Application level settings can be initialized or
retrieved from the object store before the initial View is created.
This method must be overridden to handle your own app initialization.
state [Toybox::Lang::Dictionary] Required. If an

{Toybox::System::Intent Intent} is not used to launch the application,
then an empty "state" Dictionary is used. If an Intent is used to
start the application the Dictionary contains the arguments from
the Intent.
@option state [Toybox::Lang::Boolean] :resume If true, indicates
app has been resumed from suspension, restore the previously saved
app state if needed.
@note the suspension state can be cleared in the event of reboot or app update.
@option state [Toybox::Lang::Boolean] :launchedFromGlance If true,
indicates the app is started from glance list as opposed to the
the app list.
@option state [Toybox::Lang::Number] :launchedFromComplication If present,
indicates the complication index the app was launched from.
@option state [Toybox::Lang::Number] :launchedFromPostInstall If present,
indicates the app was launched from a post-install page.
@option state [Toybox::Lang::Boolean] :launchedFromWatchFaceSettingsEditor If +true+
indicates the watchface is started in watchface config mode.
@option state [Toybox::Application::WatchFaceConfig::Id] :configId If present, represents the
desired watch face settings to launch watch face with.
use {Toybox::Application::WatchFaceConfig#getSettings WatchFaceConfig.getSettings()} to fetch
given settings.
@example onStart() used with Intent
function onStart(state) {
if (state != null) {
infoString = "Args:" + state.toString();
}
}
@see Toybox::System::Intent
@since 1.0.0
]]> Save the properties for the application
@since 1.0.0
@deprecated This method may be removed after System 4.
]]> Called when the application settings have been changed by Garmin
Connect Mobile (GCM) while while the app is running. Override this
method to change app behavior when settings change. This is
typically used to call for an update to the
{Toybox::WatchUi#requestUpdate WatchUi.requestUpdate()}
@example
function onSettingsChanged() { // triggered by settings change in GCM
_mainView.handleSettingUpdate();
WatchUi.requestUpdate(); // update the view to reflect changes
}
@see Toybox::WatchUi#requestUpdate WatchUi.requestUpdate()
details
@since 1.2.0
]]> Store the given data in the object.

@note Background processes cannot save properties.
@note Symbols can change from build to build and are not to be used
for for Keys or Values.
key [Toybox::Application::PropertyKeyType] The key used to store and retrieve

the value from the object store (cannot be a Symbol)
value [Toybox::Application::PropertyValueType] The value to put into the object store

@throws [Toybox::Application::ObjectStoreAccessException] Thrown
if called from a background process on device that does not have
ConnectIQ 3.2.0 support. Data can always be passed to the foreground
process from a background process with {Toybox::Background#exit Background.exit()}.
@throws [Toybox::Lang::UnexpectedTypeException] Thrown if
called with a key or value of a disallowed type
@example
using Toybox.Application;
var app = Application.getApp();

app.setProperty("number", 2); // set value for "number" key
app.setProperty("float", 3.14); // set value for "float" key
app.setProperty("string", "Hello World!"); // set value for "string" key
app.setProperty("boolean", true); // set value for "boolean" key

var int = app.getProperty("number"); // get value for "number" key
var float = app.getProperty("float"); // get value for "float" key
var string = app.getProperty("string"); // get value for "string" key
var boolean = app.getProperty("boolean"); // get value for "boolean" key
@see Toybox::Application::AppBase#getProperty getProperty()
@see Toybox::Background
@see https://developer.garmin.com/connect-iq/core-topics/persisting-data/ Core Topics - Persisting Data
@see Toybox::Application::Properties
@see Toybox::Application::Storage
@since 1.0.0
@deprecated This method may be removed after System 4.
]]> Load the properties for the application
@since 1.0.0
@deprecated This method may be removed after System 4.
]]> Override to handle application cleanup upon termination.

If the application needs to save data to the object store it should
be done in this function. Once the function is complete, the
application will terminate.
state [Toybox::Lang::Dictionary] Required. If

an {Toybox::System::Intent Intent} is not used to launch an application
on stop of the current application an empty "state" Dictionary is
used. If an Intent is used to start another application, then the
Dictionary contains the arguments from the Intent.
@option state [Toybox::Lang::Boolean] :suspend If true, the app has
been suspended and the current state can be resumed at a later time.
@note the suspension state can be cleared in the event of reboot or app update.
@see Toybox::System::Intent
@since 1.0.0
]]> Go to the next point.
Returns [Toybox::Lang::Boolean] +true+ if there is a next point, +false+ otherwise

@since 1.0.0
]]> Get the location object of the current point.
Returns [Toybox::Position::Location] Location object from cache

@since 1.0.0
]]> @since 1.0.0
]]>