# toDigits method

String toDigits(

1. int digits

)

Converts the integer to a string and left-pads it with zeroes until it reaches `digits` length.

Useful for formatting numeric values such as dates, times, and identifiers where a fixed-width string is expected.

### Example:

    final padded = 7.toDigits(3); // '007'
    final padded2 = 123.toDigits(5); // '00123'

### Parameters:

- `digits`: The total number of digits the output string should have.

### Returns:

A string version of this integer, padded with '0' on the left if necessary.

### Throws:

- If `digits` is less than or equal to zero.

### Notes:

- If the integer already has the same or more digits, it returns the number as a string.

## Implementation

    String toDigits(int digits) => toString().padLeft(digits, '0');