言語
日本語
English

Caution

お使いのブラウザはJavaScriptが無効になっております。
当サイトでは検索などの処理にJavaScriptを使用しています。
より快適にご利用頂くため、JavaScriptを有効にしたうえで当サイトを閲覧することをお勧めいたします。

JavaScript辞典

  1. トップページ
  2. JavaScript辞典
  3. 文字列.padStart() / padEnd() / repeat()

文字列.padStart() / padEnd() / repeat() 対応: ES2017(ECMAScript 2017)

文字列を指定した長さになるまで先頭や末尾に文字を埋め込んだり、同じ文字列を繰り返したりします。

構文

// 指定した長さになるまで先頭に文字を埋め込みます。
文字列.padStart(目標の長さ)
文字列.padStart(目標の長さ, "埋め込む文字列")

// 指定した長さになるまで末尾に文字を埋め込みます。
文字列.padEnd(目標の長さ)
文字列.padEnd(目標の長さ, "埋め込む文字列")

// 文字列を指定した回数だけ繰り返します。
文字列.repeat(回数)

メソッド一覧

メソッド概要
padStart(目標の長さ)文字列の長さが目標に達するまで先頭にスペースを埋め込みます。
padStart(目標の長さ, "埋め込む文字列")先頭に指定した文字列を埋め込みます。すでに目標の長さ以上の場合はそのまま返されます。
padEnd(目標の長さ)文字列の長さが目標に達するまで末尾にスペースを埋め込みます。
padEnd(目標の長さ, "埋め込む文字列")末尾に指定した文字列を埋め込みます。すでに目標の長さ以上の場合はそのまま返されます。
repeat(回数)文字列を指定した回数だけ繰り返した新しい文字列を返します。

サンプルコード

// padStart で数値のゼロ埋めを行います。
var num = "5";
console.log(num.padStart(3, "0")); // 『005』と出力されます。

// 日付のフォーマットに活用できます。
var month = "3";
var day = "7";
var date = "2026-" + month.padStart(2, "0") + "-" + day.padStart(2, "0");
console.log(date); // 『2026-03-07』と出力されます。

// padEnd で文字列を右側に揃えます。
console.log("Name".padEnd(10, ".") + "Kuu");  // 『Name......Kuu』と出力されます。
console.log("Price".padEnd(10, ".") + "500");  // 『Price.....500』と出力されます。

// すでに目標の長さ以上の場合はそのまま返されます。
console.log("Hello".padStart(3, "0")); // 『Hello』と出力されます。

// repeat で文字列を繰り返します。
console.log("Ha".repeat(3)); // 『HaHaHa』と出力されます。
console.log("-".repeat(20)); // 『--------------------』と出力されます。

// repeat に0を渡すと空文字が返されます。
console.log("abc".repeat(0)); // 空文字『』が出力されます。

概要

『文字列.padStart()』と『文字列.padEnd()』は文字列を指定した長さになるまで先頭や末尾に文字を埋め込むメソッドです。第2引数を省略するとスペースで埋められます。最もよく使われる場面は数値のゼロ埋めで、日付や時刻のフォーマット整形で重宝します。

『文字列.repeat()』は文字列を指定した回数だけ繰り返すメソッドです。区切り線の生成やインデント文字列の作成など、同じ文字列を複数回並べたい場面で使えます。引数に0を渡すと空文字が返され、負の数やInfinityを渡すとエラーが発生します。

いずれのメソッドも元の文字列は変更せず、新しい文字列を返します。

対応ブラウザ

Chrome Chrome
62 以降
56 以前 ×
Firefox Firefox
57 以降
47 以前 ×
Safari Safari
18 以降
9 以前 ×
Edge Edge
80 以降
14 以前 ×
IE IE
11 ×
全バージョンで非対応
Opera Opera
49 以降
43 以前 ×
iOS Safari iOS Safari
18 以降
9 以前 ×
Android Browser Android Browser
62 以降
56 以前 ×
Chrome Android Chrome Android
62 以降
56 以前 ×
Firefox Android Firefox Android
79 以降
47 以前 ×

記事の間違いや著作権の侵害等ございましたらお手数ですがまでご連絡頂ければ幸いです。