Import the pebble dev site into devsite/

devsite/js-docs/rocky/Date.js

@@ -0,0 +1,121 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @namespace Date
+ *
+ * @desc Creates a JavaScript Date instance that represents a single moment in
+ *  time. Date objects are based on a time value that is the number of
+ *  milliseconds since 1 January, 1970 UTC.
+ *
+ * `var d = new Date();`
+ *
+ * We fully implement standard JavaScript `Date` functions, such as: `getDay()`, `getHours()` etc.
+ *
+ * For full `Date` documentation see:
+ *  {@link https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date}
+ *
+ * ### Locale Date Methods
+ *
+ * The locale date methods ({@link #toLocaleString toLocaleString}, 
+ *  {@link #toLocaleTimeString toLocaleTimeString} and 
+ *  {@link #toLocaleDateString toLocaleDateString})  are currently limited in 
+ *  their initial implementation.
+ *
+ * Available **options**:
+ *
+ * **hour12**
+ *
+ * Use 12-hour time (as opposed to 24-hour time). Possible values are `true` and `false`; the default is locale dependent (Pebble setting).
+ *
+ * **weekday**
+ *
+ * The representation of the weekday. Possible values are "narrow", "short", "long".
+ *
+ * **year**
+ *
+ * The representation of the year. Possible values are "numeric", "2-digit".
+ *
+ * **month**
+ *
+ * The representation of the month. Possible values are "numeric", "2-digit", "narrow", "short", "long".
+ *
+ * **day**
+ *
+ * The representation of the day. Possible values are "numeric", "2-digit".
+ *
+ * **hour**
+ *
+ * The representation of the hour. Possible values are "numeric", "2-digit".
+ *
+ * **minute**
+ *
+ * The representation of the minute. Possible values are "numeric", "2-digit".
+ *
+ * **second**
+ *
+ * The representation of the second. Possible values are "numeric", "2-digit".
+ *
+ *
+ * Please note that locale based date and time functions have the following
+ *  limitations at this time:
+ *
+ *   * You cannot manually specify a locale, it's automatically based upon the 
+ *  current device settings. Locale is optional, or you can specify `undefined`.
+ *
+ *  `console.log(d.toLocaleDateString());`
+ *
+ *   * Only a single date/time value can be requested in each method call. Do 
+ *  NOT request multiple options. e.g. `{hour: 'numeric', minute: '2-digit'}`
+ *
+ *  `console.log(d.toLocaleTimeString(undefined, {hour: 'numeric'}));`
+ */
+var Date = new Object();
+
+/**
+ * @desc This method returns a string with a language sensitive representation
+ *  of this date object.
+ *
+ * `d.toLocaleString();`
+ *
+ * @param {String} locale - (Optional) The name of the locale.
+ * @param {Object} options - (Optional) Only a single option is currently supported.
+ */
+Date.toLocaleString = function(locale, options) { };
+
+/**
+ * @desc This method returns a string with a language sensitive representation
+ * of the date portion of this date object.
+ *
+ * `d.toLocaleTimeString(undefined, {hour: 'numeric'});`
+ *
+ * @param {String} locale - (Optional) The name of the locale.
+ * @param {Object} options - (Optional) Only a single option is currently supported.
+ */
+Date.toLocaleTimeString = function(locale, options) { };
+
+/**
+ * @desc This method returns a string with a language sensitive representation
+ * of the time portion of this date object.
+ *
+ * `d.toLocaleDateString(undefined, {weekday: 'long'});`
+ *
+ * @param {String} locale - (Optional) The name of the locale.
+ * @param {Object} options - (Optional) Only a single option is currently supported.
+ */
+Date.toLocaleDateString = function() { };
+
+