String Format Java: String.format, printf, dan Format Specifier

Dua Cara Memformat

Java memformat string dari sebuah template yang berisi format specifier (placeholder %) beserta nilai-nilai yang akan dimasukkan. Ada dua pintu masuk, dan sintaks keduanya identik:

• String.format(template, values...) mengembalikan String baru.
• System.out.printf(template, values...) langsung mencetak hasilnya.

public class Main {
    public static void main(String[] args) {
        String name = "Ada";
        int age = 36;

        String line = String.format("%s is %d years old", name, age);
        System.out.println(line);

        System.out.printf("%s is %d years old%n", name, age);
    }
}

Keduanya menghasilkan teks yang sama. String.format mengembalikannya supaya bisa kamu simpan; printf menulisnya ke konsol. Perhatikan %n di akhir template printf: itu baris baru yang tidak bergantung pada platform (utamakan ini daripada \n di format string).

Specifier yang Umum

Setiap specifier diawali % dan diakhiri huruf yang menunjukkan jenis nilai yang diharapkan:

public class Main {
    public static void main(String[] args) {
        System.out.printf("string: %s%n", "hello");
        System.out.printf("integer: %d%n", 42);
        System.out.printf("float: %f%n", 3.14);
        System.out.printf("boolean: %b%n", true);
        System.out.printf("char: %c%n", 'A');
        System.out.printf("hex: %x%n", 255);
        System.out.printf("percent sign: %%%n");
    }
}

Tiga yang paling sering dipakai adalah %s (nilai apa pun, lewat toString-nya), %d (bilangan bulat), dan %f (bilangan desimal). Pakai %% untuk mencetak tanda persen apa adanya. Memberikan tipe yang salah, misalnya String ke %d, akan melempar IllegalFormatConversionException saat runtime.

Mengatur Jumlah Angka Desimal

Secara default %f menampilkan enam angka desimal, dan itu jarang sesuai keinginanmu. Taruh .N sebelum f untuk menetapkan presisinya (nilainya dibulatkan):

public class Main {
    public static void main(String[] args) {
        double price = 3.14159;

        System.out.printf("%f%n", price);     // 3.141590
        System.out.printf("%.2f%n", price);   // 3.14
        System.out.printf("%.0f%n", price);   // 3
    }
}

Tambahkan flag koma untuk pemisah kelompok angka pada bilangan besar:

public class Main {
    public static void main(String[] args) {
        double total = 1234567.891;
        System.out.printf("%,.2f%n", total);   // 1,234,567.89
    }
}

Lebar dan Padding

Angka di antara % dan huruf tipe menetapkan lebar minimum kolom, dengan spasi sebagai pengisi supaya kolom-kolomnya sejajar. - di depan membuat rata kiri; 0 di depan mengisi angka dengan nol:

public class Main {
    public static void main(String[] args) {
        System.out.printf("[%10s]%n", "hi");    // right-aligned in 10 cols
        System.out.printf("[%-10s]%n", "hi");   // left-aligned
        System.out.printf("[%05d]%n", 42);      // zero-padded to width 5
    }
}

Inilah yang membuat tabel berformat dan laporan yang rapi enak dibaca, terutama saat kamu mencetak setiap baris di dalam for loop:

public class Main {
    public static void main(String[] args) {
        String[] names = {"Ada", "Boris", "Chen"};
        int[] scores = {95, 8, 142};

        for (int i = 0; i < names.length; i++) {
            System.out.printf("%-8s %5d%n", names[i], scores[i]);
        }
    }
}

%-8s membuat nama rata kiri di kolom selebar 8, dan %5d membuat skor rata kanan di kolom selebar 5, jadi angka-angkanya sejajar berapa pun jumlah digitnya.

Urutan Argumen

Secara default, specifier mengambil nilai dari kiri ke kanan. Kamu bisa mengulang atau mengubah urutan nilai dengan N$ (indeks mulai dari satu), berguna saat nilai yang sama muncul dua kali:

public class Main {
    public static void main(String[] args) {
        System.out.printf("%1$s, %1$s, hello %2$s%n", "echo", "world");
    }
}

%1$s merujuk ke argumen pertama dua kali, jadi echo dicetak dua kali.

Method formatted()

Sejak Java 15, setiap string punya method instance formatted. Mesinnya sama dengan String.format, hanya saja ditulis sebagai pemanggilan method pada template-nya:

public class Main {
    public static void main(String[] args) {
        String msg = "%s scored %d".formatted("Ada", 95);
        System.out.println(msg);
    }
}

Method ini sangat cocok dipasangkan dengan text block (string multi-baris dengan tiga tanda kutip) saat membangun output berformat yang lebih besar.

Kapan Tidak Memakai String.format

Untuk penggabungan sederhana yang hanya sekali, penggabungan biasa dengan + lebih jelas dan lebih cepat:

String greeting = "Hi, " + name + "!";   // simpler than String.format here

Pakai String.format / printf kalau kamu butuh format sungguhan, seperti jumlah angka desimal yang tetap, padding, perataan, atau pengelompokan angka, bukan sekadar menempelkan beberapa nilai.

Berikutnya: Operator

Format mengubah nilai menjadi teks. Untuk menghitung nilai-nilai itu sejak awal, kamu butuh operator Java: aritmatika, perbandingan, dan logika. Itu topik halaman berikutnya.