PHP sprintf(): định dạng chuỗi, thêm số 0 và số thập phân

sprintf() trả về một chuỗi được tạo từ một định dạng và danh sách giá trị: mỗi chỗ giữ % trong định dạng được thay bằng giá trị tiếp theo. sprintf('%s is %d years old', 'Ada', 36) trả về "Ada is 36 years old". printf() nhận cùng các đối số nhưng in kết quả ra thay vì trả về.

<?php
$name = 'Ada';
$age = 36;
$price = 4.5;

$line = sprintf('%s is %d years old', $name, $age);
echo $line, "\n";

// Two decimals, always
echo sprintf('Total: %.2f EUR', $price), "\n";

// printf prints directly
printf("Order #%05d for %s\n", 42, $name);

Các chỗ giữ được điền theo thứ tự, từ trái sang phải. %.2f luôn hiển thị hai chữ số thập phân (4.50, không phải 4.5), còn %05d đệm số bằng các số 0 cho đủ năm chữ số.

Các ký hiệu định dạng

Một chỗ giữ gồm %, các modifier tùy chọn, rồi một chữ cái cho kiểu dữ liệu:

Đổi các giá trị bên dưới rồi chạy lại:

<?php
echo sprintf('%s', 'PHP'), "\n";
echo sprintf('%d', 42.9), "\n";      // the decimals are cut off, not rounded
echo sprintf('%f', 1.5), "\n";
echo sprintf('%.2f', 1.5), "\n";
echo sprintf('%e', 1234.5678), "\n";
echo sprintf('%x %X', 255, 255), "\n";
echo sprintf('%o', 8), "\n";
echo sprintf('%b', 5), "\n";
echo sprintf('%08b', 5), "\n";       // binary padded to 8 bits
echo sprintf('%c', 65), "\n";
echo sprintf('%d%%', 50), "\n";
echo sprintf('%+d %+d', 5, -5), "\n"; // always show the sign

%d cắt bỏ phần thập phân của số thực về phía 0, nên 42.9 thành 42. Nếu bạn muốn 43, hãy làm tròn trước: sprintf('%d', round(42.9)). Một chuỗi không phải số, như 'abc', sẽ thành 0 với %d.

Thêm số 0 ở đầu

Giữa % và chữ cái, bạn có thể đặt một ký tự đệm và một độ rộng. %05d nghĩa là "đệm bằng 0 cho đủ độ rộng 5". Đây là cách thường dùng để định dạng mã đơn hàng, mã hóa đơn, giờ và ngày.

<?php
echo sprintf('%05d', 42), "\n";         // 00042
echo sprintf('%03d', 7), "\n";          // 007
echo sprintf('INV-%06d', 1234), "\n";   // INV-001234

// Times and dates from numbers
$h = 9; $m = 5; $s = 3;
echo sprintf('%02d:%02d:%02d', $h, $m, $s), "\n";
echo sprintf('%04d-%02d-%02d', 2026, 3, 14), "\n";

// A width smaller than the number never cuts it
echo sprintf('%03d', 123456), "\n";

Độ rộng là mức tối thiểu. Một số dài hơn độ rộng vẫn được in đầy đủ.

%05.2f: độ rộng và số thập phân cùng lúc

Với số thực, độ rộng tính mọi ký tự của kết quả, kể cả dấu thập phân và dấu trừ. Đó là lý do %05.2f với 3.14159 cho ra 03.14: tổng cộng năm ký tự, hai trong số đó nằm sau dấu chấm.

<?php
$pi = 3.14159;

echo sprintf('%05.2f', $pi), "\n";   // 5 characters in total
echo sprintf('%08.2f', $pi), "\n";   // 8 characters in total
echo sprintf('%.2f', $pi), "\n";     // no width, just 2 decimals
echo sprintf('%.0f', $pi), "\n";     // no decimals
echo sprintf('%.2f', 5), "\n";       // integers get decimals too
echo sprintf('%08.2f', -3.5), "\n";  // the minus sign counts

%f dùng dấu thập phân của locale hiện tại (đặt bằng setlocale()), còn %F luôn dùng dấu chấm. Nếu code của bạn có đặt locale và bạn cần dấu chấm cho JSON, CSV hoặc một API, hãy dùng %F.

Căn chỉnh văn bản thành cột

Độ rộng dương sẽ căn phải, dấu - trước độ rộng sẽ căn trái, và ' theo sau là một ký tự sẽ đặt ký tự đệm tùy chỉnh. Kết hợp lại, chúng giúp căn thẳng hàng các báo cáo và hóa đơn dạng văn bản thuần.

<?php
$items = [
    ['Coffee', 2, 3.5],
    ['Croissant', 1, 2.25],
    ['Orange juice', 3, 4],
];

printf("%-14s %3s %8s\n", 'Item', 'Qty', 'Price');
printf("%'-27s\n", '');

$total = 0;
foreach ($items as [$name, $qty, $price]) {
    $line = $qty * $price;
    $total += $line;
    printf("%-14s %3d %8.2f\n", $name, $qty, $line);
}

printf("%'-27s\n", '');
printf("%-14s %12.2f\n", 'Total', $total);
printf("[%'*10s]\n", 'stars');

%-14s đệm tên món ở bên phải cho đủ 14 ký tự, %8.2f căn phải giá tiền trong 8 ký tự, và %'-27s với một chuỗi rỗng in ra một dòng 27 dấu gạch ngang. %'*10s đệm bằng * thay vì khoảng trắng.

Đánh số đối số để dùng lại hoặc đổi thứ tự

%1$s nghĩa là "đối số thứ nhất dưới dạng chuỗi", %2$d là "đối số thứ hai dưới dạng số nguyên". Chỗ giữ có đánh số cho phép bạn dùng một giá trị hai lần hoặc đổi thứ tự mà không phải sửa danh sách đối số, điều mà người dịch rất cần khi trật tự từ khác nhau giữa các ngôn ngữ.

<?php
// Single quotes: in double quotes PHP would read $s as a variable
$format = '%1$s has %2$d new messages. Open them, %1$s?';
echo sprintf($format, 'Ada', 3), "\n";

// Same arguments, different order in the sentence
$en = 'Page %1$d of %2$d';
$ja = '全%2$dページ中%1$dページ目';
echo sprintf($en, 2, 10), "\n";
echo sprintf($ja, 2, 10), "\n";

// Modifiers go after the $
echo sprintf('%1$05.1f / %1$.3f', 2.71828), "\n";

vsprintf, printf và giá trị trả về

vsprintf() nhận các giá trị dưới dạng một mảng, rất tiện khi chúng đã nằm sẵn trong mảng. printf() trả về số byte nó đã in, còn vprintf() là phiên bản dùng mảng của printf().

<?php
$row = ['Ada', 'Lovelace', 1815];
echo vsprintf("%s %s was born in %d.\n", $row);

$bytes = printf("%s\n", 'Hello');
echo "printf printed $bytes bytes\n";

// Same result, two ways
echo sprintf('%.1f%%', 12.345), "\n";
printf("%.1f%%\n", 12.345);

Con số từ printf() tính cả dấu xuống dòng, nên "Hello\n" là 6 byte. Với văn bản nhiều byte như tiếng Việt có dấu, nó đếm byte chứ không đếm ký tự.

Thiếu đối số sẽ ném lỗi

Từ PHP 8, một định dạng có nhiều chỗ giữ hơn số giá trị sẽ ném ArgumentCountError thay vì trả về false. Khi gặp lỗi này, hãy đếm các chỗ giữ % (bỏ qua %%).

<?php
// This throws an ArgumentCountError on purpose: 3 placeholders, 2 values
echo sprintf('%s bought %d items for %.2f', 'Ada', 3);

Thông báo lỗi tính cả chuỗi định dạng là một đối số: ArgumentCountError: 4 arguments are required, 3 given. Đối số thừa thì bị bỏ qua mà không báo gì, nên lỗi ngược lại sẽ không hiện ra như một lỗi. Nếu kết quả sprintf trông không đúng, hãy in chuỗi định dạng ra cạnh các giá trị. Khi bạn chỉ cần dấu phân cách hàng nghìn, number_format() đơn giản hơn tự tạo bằng sprintf. Danh sách đầy đủ các modifier có trên php.net.