[Term Entry] Javascript Method : .toLocaleString() #4608

lamiaelhbari · 2024-05-05T17:35:37Z

Description

Added the .toLocaleString() term for javascript
Closes Issue [Entry] JavaScript Dates: .toLocaleString() #3997

Issue Solved

Type of Change

Adding a new entry

Checklist

All writings are my own.
My entry follows the Codecademy Docs style guide.
My changes generate no new warnings.
I have performed a self-review of my own writing and code.
I have checked my entry and corrected any misspellings.
I have made corresponding changes to the documentation if needed.
I have confirmed my changes are not being pushed from my forked main branch.
I have confirmed that I'm pushing from a new branch named after the changes I'm making.
I have linked any issues that are relevant to this PR in the Issues Solved section.

CLAassistant · 2024-05-05T17:35:42Z

All committers have signed the CLA.

mamtawardhani

Hey @lamiaelhbari, thank you for contributing to Codecademy Docs!
The entry is well written, however, a few things are to be looked at:

(1) Please sign the CLA.
(2) I've provided suggestions and comments on various parts of this entry, please review and modify them at your earliest convenience.

Thank you!

mamtawardhani · 2024-05-06T08:08:49Z

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

+---
+Title: 'toLocaleString Method'
+Description: 'A method to format a Date object as a string, based on the locale.'
+Subjects:
+  - 'Computer Science'
+  - 'Web Development'
+
+Tags:
+  - 'JavaScript'
+  - 'Methods'
+  - 'Date'
+
+CatalogContent:
+  - 'learn-javascript'
+  - 'paths/web-development'
+---


Suggested change

---

Title: 'toLocaleString Method'

Description: 'A method to format a Date object as a string, based on the locale.'

Subjects:

- 'Computer Science'

- 'Web Development'

Tags:

- 'JavaScript'

- 'Methods'

- 'Date'

CatalogContent:

- 'learn-javascript'

- 'paths/web-development'

---

---

Title: 'toLocaleString()'

Description: 'Returns a string formatted based on the locale for a Date object in JavaScript.'

Subjects:

- 'Computer Science'

- 'Web Development'

Tags:

- 'Date'

- 'Methods'

- 'Strings'

CatalogContent:

- 'introduction-to-javascript

- 'paths/front-end-engineer-career-path'

---

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

mamtawardhani · 2024-05-06T08:51:36Z

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

+
+# toLocaleString() Method :
+
+The `.toLocaleString()` method in JavaScript is used to format a [`Date` object](https://www.codecademy.com/resources/docs/javascript/dates), as a string based on the specified locale. This means it takes into account cultural settings such as `language` and `date/time` formatting preferences specific to the selected region or country.


Suggested change

The `.toLocaleString()` method in JavaScript is used to format a [`Date` object](https://www.codecademy.com/resources/docs/javascript/dates), as a string based on the specified locale. This means it takes into account cultural settings such as `language` and `date/time` formatting preferences specific to the selected region or country.

The `.toLocaleString()` method in JavaScript formats a [Date](https://www.codecademy.com/resources/docs/javascript/dates) object as a string according to the specified locale, considering cultural settings such as `language` and `date/time` formatting preferences specific to the chosen region or country.

mamtawardhani · 2024-05-06T08:57:51Z

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

+```js {copy}
+toLocaleString(locales [, options])
+```


Suggested change

```js {copy}

toLocaleString(locales [, options])

```

```js

dateObj.toLocaleString(locales, options)

mamtawardhani · 2024-05-06T09:04:18Z

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

+- `locales` : Represents the `locale or locales` to use when formatting the `date`.
+- `options` : Contains additional formatting options for the `date`, such as the format of the `weekday`, `month`, `year`, etc.
+


Suggested change

- `locales` : Represents the `locale or locales` to use when formatting the `date`.

- `options` : Contains additional formatting options for the `date`, such as the format of the `weekday`, `month`, `year`, etc.

- `dateObj`: The `Date` object used to format as a string based on the locale.

- `locales`: A `string` or an `array of strings` that specifies one or more `locales` or language tags for formatting the date.

- `options`: An object that allows customizing the formatting behavior, such as specifying the format for `date`, `time`, `numeric values`, and more.

> **Note:** Both the `locales` and `options` parameters in the `.toLocaleString()` method are optional. If the parameters are not provided, the method will use `default` values based on the runtime environment.

mamtawardhani · 2024-05-06T09:22:31Z

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

+
+## Runnable Code Example : 
+```js {copy}
+const date = new Date(1985,7,4);  
+const options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' };
+
+// Formatting for English (United States) :
+console.log(date.toLocaleString('en-US', options));
+
+// Formatting for Korean (South Korea) :
+console.log(date.toLocaleString('ko-KR', options));
+
+// Formatting for Hindi (India) : 
+console.log(date.toLocaleString('hi-IN', options));
+```
+In this example, we use `toLocaleString()` to format the current `date` and `time` with the specified formatting options for `English` (United States), `Korean` (South Korea), and `Hindi` (India).
+
+
+```shell {copy}
+// Output : 
+For English (United States): "Sunday, August 4, 1985" .
+For Korean (South Korea):  "1985년 8월 4일 일요일" .
+For Hindi (India): "रविवार, 4 अगस्त 1985" .
+```
+
+


The lines 45 to 70 can be removed. Only one ## Example and one ## Codebyte Example is needed.

mamtawardhani · 2024-05-06T09:23:38Z

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

+
+In the following example the variables `locale` and `options` can be modified, to print the `Date` in a custom format:
+
+```codebyte/js


Suggested change

```codebyte/js

```codebyte/javascript

mamtawardhani · 2024-05-06T09:26:23Z

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

+
+

Suggested change

mamtawardhani · 2024-05-06T09:30:05Z

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

+Depending on the current `date` and `time` when the code is executed.
+


Suggested change

Depending on the current `date` and `time` when the code is executed.

mamtawardhani · 2024-05-06T09:30:24Z

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

+  weekday: 'long',
+};
+
+console.log(date.toLocaleDateString(locale, options));


Suggested change

console.log(date.toLocaleDateString(locale, options));

console.log(date.toLocaleString(locale, options));

lamiaelhbari · 2024-05-06T11:29:28Z

Hi @mamtawardhani , Thank you for your detailed suggestions!

I will take your comments into consideration and make the necessary changes as soon as possible.
I will keep you informed of the progress. If you have any questions or requests, please feel free to let me know.

Thanks again for your assistance!

mamtawardhani · 2024-05-14T07:50:32Z

Hello @lamiaelhbari! Could you please make the required changes at your earliest convenience?
Thanks!

lamiaelhbari · 2024-05-15T10:34:33Z

Hello @mamatawardhani,

I have addressed all the requested changes and updated the branch. All CI checks have passed successfully. Could you please review the updates and approve the workflow?

Thank you for your time and assistance!

mamtawardhani

Thank you @lamiaelhbari for making the required changes!

Looks for the second review

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

avdhoottt

Hey @lamiaelhbari, excellent entry! I have suggested some changes, please make them.

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

mamtawardhani · 2024-05-31T11:53:48Z

Hey @lamiaelhbari are you still working on this?

…eString.md

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md

…eString.md

avdhoottt

Made the changes and merged this PR myself as the author is not responding.

github-actions · 2024-06-04T18:23:42Z

👋 @lamiaelhbari
You have contributed to Codecademy Docs, and we would like to know more about you and your experience.
Please take a minute to fill out this four question survey to help us better understand Docs contributions and how we can improve the experience for you and our learners.
Thank you for your help!

🎉 Your contribution(s) can be seen here:

https://www.codecademy.com/resources/docs/javascript/dates/toLocaleString

Please note it may take a little while for changes to become visible.
If you're appearing as anonymous and want to be credited, see here.

Create toLocaleString term for JavaScript toLocaleString method

0c9d9de

mamtawardhani self-assigned this May 5, 2024

mamtawardhani added javascript JavaScript entries new entry New entry or entries status: under review Issue or PR is currently being reviewed labels May 5, 2024

mamtawardhani requested changes May 6, 2024

View reviewed changes

mamtawardhani added status: review 1️⃣ completed status: waiting for author and removed status: under review Issue or PR is currently being reviewed labels May 6, 2024

lamiaelhbari and others added 2 commits May 6, 2024 15:26

fix formatting file as per changes on pull request

0bbc842

Update toLocaleString.md

73fcd41

ishg-153 linked an issue May 15, 2024 that may be closed by this pull request

[Entry] JavaScript Dates: .toLocaleString() #3997

Closed

3 tasks

Merge branch 'main' into toLocaleStringMethod

d97801b

lamiaelhbari requested a review from mamtawardhani May 15, 2024 10:24

mamtawardhani added 5 commits May 15, 2024 16:34

Update toLocaleString.md

6602fd9

Update toLocaleString.md

9d25fba

Update toLocaleString.md

97feb53

Update toLocaleString.md

3c7d6de

Update toLocaleString.md

fd73ca8

mamtawardhani approved these changes May 15, 2024

View reviewed changes

mamtawardhani added status: ready for next review and removed status: waiting for author labels May 15, 2024

avdhoottt added status: under review Issue or PR is currently being reviewed and removed status: ready for next review labels May 15, 2024

avdhoottt self-assigned this May 15, 2024

Merge branch 'main' into toLocaleStringMethod

2cdc94a

avdhoottt reviewed May 16, 2024

View reviewed changes

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md Outdated Show resolved Hide resolved

avdhoottt reviewed May 16, 2024

View reviewed changes

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md Outdated Show resolved Hide resolved

avdhoottt requested changes May 16, 2024

View reviewed changes

avdhoottt added status: review 2️⃣ completed status: waiting for author and removed status: under review Issue or PR is currently being reviewed labels May 16, 2024

avdhoottt added 8 commits June 4, 2024 23:32

Update content/javascript/concepts/dates/terms/toLocaleString/toLocal…

e503c24

…eString.md

Update content/javascript/concepts/dates/terms/toLocaleString/toLocal…

555eda4

…eString.md

Update content/javascript/concepts/dates/terms/toLocaleString/toLocal…

cd1c87e

…eString.md

Update content/javascript/concepts/dates/terms/toLocaleString/toLocal…

84d3aab

…eString.md

Update content/javascript/concepts/dates/terms/toLocaleString/toLocal…

bd938b9

…eString.md

Update content/javascript/concepts/dates/terms/toLocaleString/toLocal…

5946cbf

…eString.md

Update content/javascript/concepts/dates/terms/toLocaleString/toLocal…

f0e77db

…eString.md

Update content/javascript/concepts/dates/terms/toLocaleString/toLocal…

9592c4a

…eString.md

avdhoottt reviewed Jun 4, 2024

View reviewed changes

content/javascript/concepts/dates/terms/toLocaleString/toLocaleString.md Show resolved Hide resolved

Update content/javascript/concepts/dates/terms/toLocaleString/toLocal…

c2125d0

…eString.md

avdhoottt approved these changes Jun 4, 2024

View reviewed changes

avdhoottt and others added 2 commits June 4, 2024 23:36

Merge branch 'main' into toLocaleStringMethod

89ef5fb

Format + Lint Error

93cd5c8

avdhoottt removed the status: waiting for author label Jun 4, 2024

avdhoottt merged commit dd55979 into Codecademy:main Jun 4, 2024


		# toLocaleString() Method :

		The `.toLocaleString()` method in JavaScript is used to format a [`Date` object](https://www.codecademy.com/resources/docs/javascript/dates), as a string based on the specified locale. This means it takes into account cultural settings such as `language` and `date/time` formatting preferences specific to the selected region or country.

		- `locales` : Represents the `locale or locales` to use when formatting the `date`.
		- `options` : Contains additional formatting options for the `date`, such as the format of the `weekday`, `month`, `year`, etc.

-- `locales` : Represents the `locale or locales` to use when formatting the `date`.
-- `options` : Contains additional formatting options for the `date`, such as the format of the `weekday`, `month`, `year`, etc.
+- `dateObj`: The `Date` object used to format as a string based on the locale.
+- `locales`: A `string` or an `array of strings` that specifies one or more `locales` or language tags for formatting the date.
+- `options`: An object that allows customizing the formatting behavior, such as specifying the format for `date`, `time`, `numeric values`, and more.
+> **Note:** Both the `locales` and `options` parameters in the `.toLocaleString()` method are optional. If the parameters are not provided, the method will use `default` values based on the runtime environment.


		In the following example the variables `locale` and `options` can be modified, to print the `Date` in a custom format:

		```codebyte/js

		Depending on the current `date` and `time` when the code is executed.

	console.log(date.toLocaleDateString(locale, options));
	console.log(date.toLocaleString(locale, options));

[Term Entry] Javascript Method : .toLocaleString() #4608

[Term Entry] Javascript Method : .toLocaleString() #4608

Uh oh!

Conversation

lamiaelhbari commented May 5, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Issue Solved

Type of Change

Checklist

Uh oh!

CLAassistant commented May 5, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mamtawardhani left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

lamiaelhbari commented May 6, 2024

Uh oh!

mamtawardhani commented May 14, 2024

Uh oh!

lamiaelhbari commented May 15, 2024

Uh oh!

mamtawardhani left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

avdhoottt left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mamtawardhani commented May 31, 2024

Uh oh!

Uh oh!

avdhoottt left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Jun 4, 2024

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

lamiaelhbari commented May 5, 2024 •

edited

Loading

CLAassistant commented May 5, 2024 •

edited

Loading